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
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
부모의 컨텍스트에서 이 리소스의 주소를 설명합니다. Parent 및 AddressOnParent 속성은 컨트롤러 관계 및 컨트롤러의 디바이스 순서를 설명하는 데 사용됩니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
AllocationUnits
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
예약 및 제한 속성에서 사용하는 할당 단위입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
AllowPacketDirect
-
-
데이터 형식: boolean
-
액세스 형식: 읽기/쓰기
VM에 대해 PacketDirect 프로젝션을 사용할 수 있는지를 나타냅니다.
참고
Windows 10 버전 1703 및 Windows Server 2016 추가되었습니다.
-
-
AutomaticAllocation
-
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
리소스가 자동으로 할당되는지 여부를 나타냅니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
AutomaticDeallocation
-
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
리소스의 할당을 자동으로 취소할지 여부를 나타냅니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
캡션
-
-
데이터 형식: string
-
액세스 형식: 읽기 전용
개체에 대한 간단한 설명입니다. 이 속성은 CIM_ManagedElement 상속됩니다.
-
-
ClusterMonitored
-
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
이 이더넷 어댑터가 클러스터에서 모니터링되는지 여부를 나타냅니다. 구성되지 않은 경우 이 속성은 기본적으로 true로 설정됩니다.
읽기 전용 속성이지만 Msvm_VirtualSystemManagementService 클래스의ModifyResourceSettings 메서드를 사용하여 변경할 수 있습니다.
Windows 8.1: 이 값은 Windows 8.1 R2를 Windows Server 2012 때까지 지원되지 않습니다.
-
-
연결
-
-
데이터 형식: 문자열 배열
-
액세스 형식: 읽기 전용
이 리소스가 연결된 것입니다. 예를 들어 명명된 네트워크 또는 스위치 포트입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
ConsumerVisibility
-
-
데이터 형식: uint16
-
액세스 형식: 읽기 전용
소비자가 할당된 리소스를 표시합니다. 이 속성은 CIM_ResourceAllocationSettingData 상속되며 항상 3(가상화됨)으로 설정됩니다.
-
-
설명
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
개체에 대한 설명입니다. 이 속성은 CIM_ManagedElement 상속됩니다.
-
-
DesiredVLANEndpointMode
-
-
데이터 형식: uint16
-
액세스 형식: 읽기 전용
VLAN 엔드포인트에 대한 원하는 구성 모드입니다. 이 속성은 대상 이더넷 포트와 연결된 Msvm_VLANEndpoint 클래스의 instance 초기 OperationalEndpointMode 속성 값을 설정하는 데 사용됩니다. 가능한 값은 Msvm_VLANEndpoint 클래스의 OperationalEndpointMode 속성을 참조하세요. 이 속성은 CIM_EthernetPortAllocationSettingData 상속됩니다.
-
-
DeviceNamingEnabled
-
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
이 이더넷 어댑터가 디바이스 이름을 지원하는지 여부를 나타냅니다.
읽기 전용 속성이지만 Msvm_VirtualSystemManagementService 클래스의ModifyVirtualSystemResources 메서드를 사용하여 변경할 수 있습니다.
참고
Windows 10 및 Windows Server 2016 추가되었습니다.
-
-
ElementName
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
개체에 대한 간단한 설명입니다. 이 속성은 CIM_SettingData 상속됩니다.
-
-
HostResource
-
-
데이터 형식: 문자열 배열
-
액세스 형식: 읽기 전용
이 속성은 CIM_ResourceAllocationSettingData 상속되며 항상 Null로 설정됩니다.
-
-
InstanceID
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: Key
이 클래스의 instance 고유하게 식별합니다. 이 속성은 CIM_ManagedElement 상속됩니다.
-
-
제한
-
-
데이터 형식: uint64
-
액세스 형식: 읽기 전용
이 할당에 대해 부여될 상한 또는 최대 리소스 양입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
MappingBehavior
-
-
데이터 형식: uint16
-
액세스 형식: 읽기 전용
이 리소스가 기본 리소스에 매핑되는 방법을 지정합니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
OtherEndpointMode
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
이 VLAN 엔드포인트에서 지원하는 VLAN 엔드포인트 모델의 형식을 설명하는 문자열입니다. 이 속성은 DesiredVLANEndpointMode 속성이 1(기타)로 설정된 경우에만 사용됩니다. DesiredVLANEndpointMode 속성이 1 이외의 값이면 이 속성을 Null로 설정해야 합니다. 이 속성은 CIM_EthernetPortAllocationSettingData 상속됩니다.
-
-
OtherResourceType
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
잘 정의된 값을 사용할 수 없으며 ResourceType 이 "기타"(0)로 설정된 경우 리소스 유형을 설명하는 문자열입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속되며 사용되지 않습니다.
-
-
부모
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
리소스의 부모입니다. 예를 들어 현재 할당에 대한 컨트롤러입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
PoolID
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
리소스가 현재 할당된 풀이거나 할당이 발생할 때 리소스가 할당될 풀입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
예약
-
-
데이터 형식: uint64
-
액세스 형식: 읽기 전용
이 할당에 사용할 수 있도록 보장되는 리소스의 양입니다. 리소스의 과다 약정을 지원하는 시스템에서 이 값은 일반적으로 할당이 수락되지 않도록 허용 제어에 사용됩니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
ResourceSubType
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
이 리소스에 대한 구현 특정 하위 형식을 설명하는 문자열입니다. 예를 들어 동일한 리소스 유형의 다른 모델을 구분하는 데 사용할 수 있습니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
ResourceType
-
-
데이터 형식: uint16
-
액세스 형식: 읽기 전용
이 설정이 적용되는 리소스 유형입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속되며 항상 10(이더넷 어댑터)으로 설정됩니다.
-
-
StaticMacAddress
-
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
MAC 주소가 정적인지를 지정합니다.
-
-
VirtualQuantity
-
-
데이터 형식: uint64
-
액세스 형식: 읽기 전용
소비자에게 제공되는 리소스의 수량입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
VirtualQuantityUnits
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
VirtualQuantity 속성의 측정 단위를 지정합니다. 이 속성의 값은 DSP0004 V2.5 이상의 부속서 C.1에 정의된 대로 프로그래밍 단위 한정자의 법적 값이어야 합니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
-
VirtualSystemIdentifiers
-
-
데이터 형식: 문자열 배열
-
액세스 형식: 읽기 전용
-
한정자: ArrayType ("Indexed")
가상 머신의 운영 체제에 표시되는 이 리소스의 식별자 문자열 배열입니다. 인덱스당 인덱스 및 값은 리소스별로 정의됩니다(즉, 열거된 각 ResourceType 속성 값에 대해).
-
-
가중치
-
-
데이터 형식: uint32
-
액세스 형식: 읽기 전용
동일한 리소스 풀의 다른 할당과 관련하여 이 할당에 대한 상대적 우선 순위입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.
-
설명
Msvm_SyntheticEthernetPortSettingData 클래스에 대한 액세스는 UAC 필터링에 의해 제한될 수 있습니다. 자세한 내용은 사용자 계정 컨트롤 및 WMI를 참조하세요.
예제
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows 8 [데스크톱 앱만 해당] |
지원되는 최소 서버 |
Windows Server 2012 [데스크톱 앱만 해당] |
네임스페이스 |
Root\Virtualization\V2 |
MOF |
|
DLL |
|
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기