Msvm _ SyntheticEthernetPortSettingData 클래스Msvm_SyntheticEthernetPortSettingData class

가상 이더넷 어댑터의 구성 된 상태를 나타냅니다.Represents the configured state of a synthetic Ethernet adapter.

다음 구문은 MOF (단순화 MOF(Managed Object Format)) 코드 이며 상속 된 모든 속성을 포함 합니다.The following syntax is simplified Managed Object Format (MOF) code, and it includes all of the inherited properties.

구문Syntax

[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;
};

구성원Members

Msvm _ SyntheticEthernetPortSettingData 클래스에는 다음과 같은 유형의 멤버가 있습니다.The Msvm_SyntheticEthernetPortSettingData class has these types of members:

속성Properties

Msvm _ SyntheticEthernetPortSettingData 클래스에는 이러한 속성이 있습니다.The Msvm_SyntheticEthernetPortSettingData class has these properties.

주소Address

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

리소스의 주소입니다.The address of the resource. 예를 들어, 이더넷 포트의 MAC 주소입니다.For example, the MAC address of a Ethernet port. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

AddressOnParentAddressOnParent

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

부모 컨텍스트의이 리소스에 대 한 주소를 설명 합니다.Describes the address of this resource in the context of the parent. 부모AddressOnParent 속성은 컨트롤러 관계 뿐만 아니라 컨트롤러의 장치 순서를 설명 하는 데 사용 됩니다.The Parent and AddressOnParent properties are used to describe the controller relationship as well as the ordering of devices on a controller. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

AllocationUnitsAllocationUnits

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

예약제한 속성에서 사용 하는 할당 단위입니다.The units of allocation used by the Reservation and Limit properties. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

AllowPacketDirectAllowPacketDirect

데이터 형식: booleanData type: boolean

액세스 형식: 읽기/쓰기Access type: Read/write

VM에 대해 PacketDirect 프로젝션이 사용 되는지 여부를 나타냅니다.Indicates if PacketDirect projection is enabled for the VM.

참고

Windows 10, 버전 1703 및 Windows Server 2016에서 추가 되었습니다.Added in Windows 10, version 1703 and Windows Server 2016.

자동 할당AutomaticAllocation

데이터 형식: booleanData type: boolean

액세스 형식: 읽기 전용Access type: Read-only

리소스가 자동으로 할당 되는지 여부를 나타냅니다.Indicates whether the resource will be automatically allocated. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

자동 할당 취소AutomaticDeallocation

데이터 형식: booleanData type: boolean

액세스 형식: 읽기 전용Access type: Read-only

리소스가 자동으로 할당 취소 될 지 여부를 나타냅니다.Indicates whether the resource will be automatically deallocated. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

캡션Caption

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

개체에 대 한 간단한 설명입니다.A short description of the object. 이 속성은 CIM _ ManagedElement에서 상속 됩니다.This property is inherited from CIM_ManagedElement.

ClusterMonitored 됨ClusterMonitored

데이터 형식: booleanData type: boolean

액세스 형식: 읽기 전용Access type: Read-only

이 이더넷 어댑터를 클러스터에서 모니터링 하는지 여부를 나타냅니다.Indicates whether this ethernet adapter is monitored by a cluster. 구성 되지 않은 경우이 속성의 기본값은 true입니다.This property defaults to true if not configured.

이 속성은 읽기 전용 속성 이지만 Msvm _ VirtualSystemManagementService 클래스의 ModifyResourceSettings 메서드를 사용 하 여 변경할 수 있습니다.This is a read-only property, but it can be changed by using the ModifyResourceSettings method of the Msvm_VirtualSystemManagementService class.

Windows 8.1: Windows 8.1 및 Windows Server 2012 R2 까지는이 값이 지원 되지 않습니다.Windows 8.1: This value is not supported until Windows 8.1 and Windows Server 2012 R2.

연결Connection

데이터 형식: 문자열 배열Data type: string array

액세스 형식: 읽기 전용Access type: Read-only

이 리소스가 연결 되는 대상입니다.The thing to which this resource is connected. 예를 들어 명명 된 네트워크 또는 스위치 포트입니다.For example, a named network or switch port. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

ConsumerVisibilityConsumerVisibility

데이터 형식: uint16Data type: uint16

액세스 형식: 읽기 전용Access type: Read-only

할당 된 리소스에 대 한 소비자의 표시 여부입니다.The consumers visibility to the allocated resource. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 되며 항상 3 (가상화)로 설정 됩니다.This property is inherited from CIM_ResourceAllocationSettingData, and it is always set to 3 (Virtualized).

설명Description

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

개체에 대한 설명입니다.A description of the object. 이 속성은 CIM _ ManagedElement에서 상속 됩니다.This property is inherited from CIM_ManagedElement.

DesiredVLANEndpointModeDesiredVLANEndpointMode

데이터 형식: uint16Data type: uint16

액세스 형식: 읽기 전용Access type: Read-only

VLAN 끝점에 대 한 원하는 구성 모드입니다.The desired configuration mode for the VLAN endpoint. 이 속성은 대상 이더넷 포트와 연결 된 Msvm _ VLANEndpoint 클래스의 인스턴스에서 초기 OperationalEndpointMode 속성 값을 설정 하는 데 사용 됩니다.This property is used to set the initial OperationalEndpointMode property value in the instance of the Msvm_VLANEndpoint class associated with the targeted Ethernet port. 가능한 값은 Msvm _ VLANEndpoint 클래스의 OperationalEndpointMode 속성을 참조 하세요.See the OperationalEndpointMode property of the Msvm_VLANEndpoint class for possible values. 이 속성은 CIM _ EthernetPortAllocationSettingData 에서 상속 됩니다.This property is inherited from CIM_EthernetPortAllocationSettingData.

DeviceNamingEnabledDeviceNamingEnabled

데이터 형식: booleanData type: boolean

액세스 형식: 읽기 전용Access type: Read-only

이 이더넷 어댑터가 장치 이름 지정을 지원 하는지 여부를 나타냅니다.Indicates whether this ethernet adapter supports device naming.

이 속성은 읽기 전용 속성 이지만 Msvm _ VirtualSystemManagementService 클래스의 ModifyVirtualSystemResources 메서드를 사용 하 여 변경할 수 있습니다.This is a read-only property, but it can be changed using the ModifyVirtualSystemResources method of the Msvm_VirtualSystemManagementService class.

참고

Windows 10 및 Windows Server 2016에 추가 되었습니다.Added in Windows 10 and Windows Server 2016.

ElementNameElementName

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

개체에 대 한 간단한 설명입니다.A short description of the object. 이 속성은 CIM _ SettingData에서 상속 됩니다.This property is inherited from CIM_SettingData.

HostResourceHostResource

데이터 형식: 문자열 배열Data type: string array

액세스 형식: 읽기 전용Access type: Read-only

이 속성은 CIM _ ResourceAllocationSettingData에서 상속 되며 항상 Null 로 설정 됩니다.This property is inherited from CIM_ResourceAllocationSettingData, and it is always set to Null.

InstanceIDInstanceID

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

한정자: KeyQualifiers: Key

이 클래스의 인스턴스를 고유 하 게 식별 합니다.Uniquely identifies an instance of this class. 이 속성은 CIM _ ManagedElement에서 상속 됩니다.This property is inherited from CIM_ManagedElement.

제한Limit

데이터 형식: uint64Data type: uint64

액세스 형식: 읽기 전용Access type: Read-only

이 할당에 대해 허용 되는 상한 또는 최대 리소스 양입니다.The upper bound, or maximum amount of resource that will be granted for this allocation. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

MappingBehaviorMappingBehavior

데이터 형식: uint16Data type: uint16

액세스 형식: 읽기 전용Access type: Read-only

이 리소스가 기본 리소스에 매핑되는 방법을 지정 합니다.Specifies how this resource maps to underlying resources. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

OtherEndpointModeOtherEndpointMode

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

이 VLAN 끝점에서 지 원하는 VLAN 끝점 모델의 유형을 설명 하는 문자열입니다.A string that describes the type of VLAN endpoint model that is supported by this VLAN endpoint. 이 속성은 DesiredVLANEndpointMode 속성이 1로 설정 된 경우에만 사용 됩니다.This property is only used when the DesiredVLANEndpointMode property is set to 1 (Other). DesiredVLANEndpointMode 속성이 1이 아닌 값 이면이 속성을 Null 로 설정 해야 합니다.This property should be set to Null when the DesiredVLANEndpointMode property is any value other than 1. 이 속성은 CIM _ EthernetPortAllocationSettingData 에서 상속 됩니다.This property is inherited from CIM_EthernetPortAllocationSettingData.

OtherResourceTypeOtherResourceType

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

잘 정의 된 값을 사용할 수 없고 ResourceType 이 "Other" (0)로 설정 된 경우 리소스 종류를 설명 하는 문자열입니다.A string that describes the resource type when a well-defined value is not available and ResourceType is set to "Other" (0). 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 되며 사용 되지 않습니다.This property is inherited from CIM_ResourceAllocationSettingData, and it is not used.

부모Parent

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

리소스의 부모입니다.The parent of the resource. 예를 들어 현재 할당에 대 한 컨트롤러입니다.For example, a controller for the current allocation. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

PoolIDPoolID

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

리소스가 현재 할당 되어 있는 풀 이거나, 할당을 수행 했을 때 리소스가 할당 될 풀입니다.The pool the resource is currently allocated from, or which pool the resource will be allocated from when the allocation occurs. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

예약Reservation

데이터 형식: uint64Data type: uint64

액세스 형식: 읽기 전용Access type: Read-only

이 할당에 사용할 수 있도록 보장 된 리소스의 양입니다.The amount of resource guaranteed to be available for this allocation. 과도 한 리소스 약정을 지 원하는 시스템에서는 일반적으로이 값을 허용 제어에 사용 하 여 할당이 허용 되지 않도록 합니다.On systems that support over-commitment of resources, this value is typically used for admission control to prevent an allocation from being accepted. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

ResourceSubTypeResourceSubType

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

이 리소스의 구현 별 하위 유형을 설명 하는 문자열입니다.A string that describes an implementation specific subtype for this resource. 예를 들어이를 사용 하 여 동일한 리소스 유형의 여러 모델을 구분할 수 있습니다.For example, this may be used to distinguish different models of the same resource type. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

ResourceTypeResourceType

데이터 형식: uint16Data type: uint16

액세스 형식: 읽기 전용Access type: Read-only

이 설정이 적용 되는 리소스의 유형입니다.The type of resource this setting applies to. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 되며 항상 10 (이더넷 어댑터)으로 설정 됩니다.This property is inherited from CIM_ResourceAllocationSettingData, and it is always set to 10 (Ethernet Adapter).

StaticMacAddressStaticMacAddress

데이터 형식: booleanData type: boolean

액세스 형식: 읽기 전용Access type: Read-only

MAC 주소가 고정 인지 여부를 지정 합니다.Specifies if the MAC address is static.

VirtualQuantityVirtualQuantity

데이터 형식: uint64Data type: uint64

액세스 형식: 읽기 전용Access type: Read-only

소비자에 게 제공 되는 리소스의 양입니다.The quantity of resources presented to the consumer. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

VirtualQuantityUnitsVirtualQuantityUnits

데이터 형식: 문자열Data type: string

액세스 형식: 읽기 전용Access type: Read-only

Virtualquantity 속성의 단위를 지정 합니다.Specifies the unit of measurement for the VirtualQuantity property. 이 속성의 값은 DSP0004 V 2.5 이상의 부록 C. 1에 정의 된 프로그래밍 단위 한정자의 올바른 값 이어야 합니다.The value of this property must be a legal value of the Programmatic Units qualifier as defined in Annex C.1 of DSP0004 V2.5 or later. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

VirtualSystemIdentifiersVirtualSystemIdentifiers

데이터 형식: 문자열 배열Data type: string array

액세스 형식: 읽기 전용Access type: Read-only

한정자: ArrayType ("인덱싱된")Qualifiers: ArrayType ("Indexed")

가상 컴퓨터의 운영 체제에 제공 되는이 리소스의 식별자로 이루어진 문자열 배열입니다.A string array of identifiers of this resource presented to the virtual machine's operating system. 인덱스 당 인덱스 및 값은 리소스 별로 정의 됩니다 (즉, 열거 된 각 ResourceType 속성 값의 경우).The indexes and values per index are defined on a per resource basis (that is, for each enumerated ResourceType property value).

WeightWeight

데이터 형식: uint32Data type: uint32

액세스 형식: 읽기 전용Access type: Read-only

동일한 리소스 풀의 다른 할당과 관련 하 여이 할당의 상대적인 우선 순위입니다.A relative priority for this allocation in relation to other allocations from the same resource pool. 이 속성은 CIM _ ResourceAllocationSettingData에서 상속 됩니다.This property is inherited from CIM_ResourceAllocationSettingData.

설명Remarks

Msvm _ SyntheticEthernetPortSettingData 클래스에 대 한 액세스는 UAC 필터링에 의해 제한 될 수 있습니다.Access to the Msvm_SyntheticEthernetPortSettingData class might be restricted by UAC Filtering. 자세한 내용은 사용자 계정 컨트롤 및 WMI를 참조 하세요.For more information, see User Account Control and WMI.

예제Examples

네트워킹 개체 쿼리를 참조 하세요.See Querying networking objects.

요구 사항Requirements

요구 사항Requirement Value
지원되는 최소 클라이언트Minimum supported client
Windows 8 [ 데스크톱 앱에만 해당]Windows 8 [desktop apps only]
지원되는 최소 서버Minimum supported server
Windows Server 2012 [ 데스크톱 앱에만 해당]Windows Server 2012 [desktop apps only]
네임스페이스Namespace
루트 \ 가상화 \ V2Root\Virtualization\V2
MOFMOF
WindowsVirtualization. V2 .mof
WindowsVirtualization.V2.mof
DLLDLL
Vmms.exe
Vmms.exe

참고 항목See also

CIM _ EthernetPortAllocationSettingDataCIM_EthernetPortAllocationSettingData

CIM _ ResourceAllocationSettingDataCIM_ResourceAllocationSettingData