Msvm_SyntheticEthernetPortSettingData 클래스

가상 이더넷 어댑터의 구성된 상태를 나타냅니다.

다음 구문은 간소화된 MOF(Managed Object Format) 코드이며 상속된 모든 속성을 포함합니다.

구문

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  InstanceID;
  string  Caption = "Virtual Ethernet Port Default Settings";
  string  Description = "Describes the default settings for the virtual Ethernet port resources.";
  string  ElementName;
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft:Hyper-V:Synthetic Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "count";
  uint64  VirtualQuantity = 1;
  uint64  Reservation = 1;
  uint64  Limit = 1;
  uint32  Weight = 0;
  boolean AutomaticAllocation = True;
  boolean AutomaticDeallocation = True;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  string  VirtualSystemIdentifiers[];
  boolean DeviceNamingEnabled = FALSE;
  boolean AllowPacketDirect = FALSE;
  boolean StaticMacAddress = False;
  boolean ClusterMonitored = TRUE;
};

멤버

Msvm_SyntheticEthernetPortSettingData 클래스에는 다음과 같은 형식의 멤버가 있습니다.

속성

Msvm_SyntheticEthernetPortSettingData 클래스에는 이러한 속성이 있습니다.

주소

데이터 형식: 문자열

액세스 형식: 읽기 전용

리소스의 주소입니다. 예를 들어 이더넷 포트의 MAC 주소입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

AddressOnParent

데이터 형식: 문자열

액세스 형식: 읽기 전용

부모 컨텍스트에서 이 리소스의 주소를 설명합니다. 부모AddressOnParent 속성은 컨트롤러의 디바이스 순서뿐만 아니라 컨트롤러 관계를 설명하는 데 사용됩니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

AllocationUnits

데이터 형식: 문자열

액세스 형식: 읽기 전용

예약제한 속성에 사용되는 할당 단위입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

AllowPacketDirect

데이터 형식: 부울

액세스 유형: 읽기/쓰기

VM에 PacketDirect 프로젝션을 사용할 수 있는지를 나타냅니다.

참고

Windows 10 버전 1703 및 Windows Server 2016 추가되었습니다.

AutomaticAllocation

데이터 형식: 부울

액세스 형식: 읽기 전용

리소스가 자동으로 할당될지 여부를 나타냅니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

AutomaticDeallocation

데이터 형식: 부울

액세스 형식: 읽기 전용

리소스의 할당을 자동으로 취소할지 여부를 나타냅니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

캡션

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 간단한 설명입니다. 이 속성은 CIM_ManagedElement 상속됩니다.

ClusterMonitored

데이터 형식: 부울

액세스 형식: 읽기 전용

이 이더넷 어댑터가 클러스터에서 모니터링되는지 여부를 나타냅니다. 구성되지 않은 경우 이 속성은 기본적으로 true로 설정됩니다.

읽기 전용 속성이지만 Msvm_VirtualSystemManagementService 클래스의ModifyResourceSettings 메서드를 사용하여 변경할 수 있습니다.

Windows 8.1: 이 값은 R2를 Windows 8.1 Windows Server 2012 때까지 지원되지 않습니다.

연결

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

이 리소스가 연결된 것입니다. 예를 들어 명명된 네트워크 또는 스위치 포트입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

ConsumerVisibility

데이터 형식: uint16

액세스 형식: 읽기 전용

할당된 리소스에 대한 소비자 표시 유형입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속되며 항상 3(가상화됨)으로 설정됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 설명입니다. 이 속성은 CIM_ManagedElement 상속됩니다.

DesiredVLANEndpointMode

데이터 형식: uint16

액세스 형식: 읽기 전용

VLAN 엔드포인트에 대한 원하는 구성 모드입니다. 이 속성은 대상 이더넷 포트와 연결된 Msvm_VLANEndpoint 클래스의 인스턴스에서 초기 OperationalEndpointMode 속성 값을 설정하는 데 사용됩니다. 가능한 값은 Msvm_VLANEndpoint 클래스의 OperationalEndpointMode 속성을 참조하세요. 이 속성은 CIM_EthernetPortAllocationSettingData 상속됩니다.

DeviceNamingEnabled

데이터 형식: 부울

액세스 형식: 읽기 전용

이 이더넷 어댑터가 디바이스 이름을 지원하는지 여부를 나타냅니다.

읽기 전용 속성이지만 Msvm_VirtualSystemManagementService 클래스의ModifyVirtualSystemResources 메서드를 사용하여 변경할 수 있습니다.

참고

Windows 10 및 Windows Server 2016 추가되었습니다.

ElementName

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 간단한 설명입니다. 이 속성은 CIM_SettingData 상속됩니다.

HostResource

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

이 속성은 CIM_ResourceAllocationSettingData 상속되며 항상 Null로 설정됩니다.

InstanceID

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자:

이 클래스의 인스턴스를 고유하게 식별합니다. 이 속성은 CIM_ManagedElement 상속됩니다.

제한

데이터 형식: uint64

액세스 형식: 읽기 전용

이 할당에 대해 부여할 상한 또는 최대 리소스 양입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

MappingBehavior

데이터 형식: uint16

액세스 형식: 읽기 전용

이 리소스가 기본 리소스에 매핑되는 방법을 지정합니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

OtherEndpointMode

데이터 형식: 문자열

액세스 형식: 읽기 전용

이 VLAN 엔드포인트에서 지원하는 VLAN 엔드포인트 모델의 유형을 설명하는 문자열입니다. 이 속성은 DesiredVLANEndpointMode 속성이 1(기타)로 설정된 경우에만 사용됩니다. DesiredVLANEndpointMode 속성이 1 이외의 값이면 이 속성을 Null로 설정해야 합니다. 이 속성은 CIM_EthernetPortAllocationSettingData 상속됩니다.

OtherResourceType

데이터 형식: 문자열

액세스 형식: 읽기 전용

잘 정의된 값을 사용할 수 없으며 ResourceType 이 "Other"(0)로 설정된 경우 리소스 종류를 설명하는 문자열입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속되며 사용되지 않습니다.

부모

데이터 형식: 문자열

액세스 형식: 읽기 전용

리소스의 부모입니다. 예를 들어 현재 할당에 대한 컨트롤러입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

PoolID

데이터 형식: 문자열

액세스 형식: 읽기 전용

리소스가 현재 할당된 풀 또는 할당이 발생할 때 리소스가 할당될 풀입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

예약

데이터 형식: uint64

액세스 형식: 읽기 전용

이 할당에 사용할 수 있도록 보장되는 리소스의 양입니다. 리소스의 과다 약정을 지원하는 시스템에서 이 값은 일반적으로 할당이 수락되지 않도록 허용 제어에 사용됩니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

ResourceSubType

데이터 형식: 문자열

액세스 형식: 읽기 전용

이 리소스에 대한 구현 특정 하위 형식을 설명하는 문자열입니다. 예를 들어 동일한 리소스 유형의 다른 모델을 구분하는 데 사용할 수 있습니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

ResourceType

데이터 형식: uint16

액세스 형식: 읽기 전용

이 설정이 적용되는 리소스의 유형입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속되며 항상 10(이더넷 어댑터)으로 설정됩니다.

StaticMacAddress

데이터 형식: 부울

액세스 형식: 읽기 전용

MAC 주소가 정적인지를 지정합니다.

VirtualQuantity

데이터 형식: uint64

액세스 형식: 읽기 전용

소비자에게 제공되는 리소스의 수량입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

VirtualQuantityUnits

데이터 형식: 문자열

액세스 형식: 읽기 전용

VirtualQuantity 속성의 측정 단위를 지정합니다. 이 속성의 값은 DSP0004 V2.5 이상의 부록 C.1에 정의된 프로그래밍 단위 한정자의 법적 값이어야 합니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

VirtualSystemIdentifiers

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

한정자: ArrayType ("인덱싱됨")

가상 머신의 운영 체제에 표시되는 이 리소스의 식별자의 문자열 배열입니다. 인덱스당 인덱스 및 값은 리소스별로 정의됩니다(즉, 열거된 각 ResourceType 속성 값에 대해).

Weight

데이터 형식: uint32

액세스 형식: 읽기 전용

동일한 리소스 풀의 다른 할당과 관련하여 이 할당에 대한 상대적 우선 순위입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

설명

Msvm_SyntheticEthernetPortSettingData 클래스에 대한 액세스는 UAC 필터링에 의해 제한될 수 있습니다. 자세한 내용은 사용자 계정 컨트롤 및 WMI를 참조하세요.

예제

네트워킹 개체 쿼리를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2012 [데스크톱 앱만 해당]
네임스페이스
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

참고 항목

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData