Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Represents an allocation request for a static or dynamic switch port, or represents the active configuration of a currently allocated static or dynamic switch port. An allocation request for a dynamic switch port is also known as a connection request.
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_EthernetPortAllocationSettingData : CIM_EthernetPortAllocationSettingData
{
  string  InstanceID = "Microsoft:GUID\DeviceSpecificData";
  string  Caption = "Ethernet Switch Port Settings";
  string  Description = "Ethernet Switch Port Settings";
  string  ElementName;
  uint16  ResourceType = 33;
  string  OtherResourceType;
  string  ResourceSubType;
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits;
  uint64  VirtualQuantity;
  uint64  Reservation;
  uint64  Limit;
  uint32  Weight = 0;
  boolean AutomaticAllocation;
  boolean AutomaticDeallocation;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  uint16  EnabledState;
  string  LastKnownSwitchName;
  string  RequiredFeatures[];
  string  RequiredFeatureHints[];
  string  TestReplicaPoolID;
  string  TestReplicaSwitchName;
  string  CompartmentGuid;
};
Members
The Msvm_EthernetPortAllocationSettingData class has these types of members:
Properties
The Msvm_EthernetPortAllocationSettingData class has these properties.
- 
Address 
-  - 
Data type: string 
- 
Access type: Read-only 
 The address of the resource. This property is inherited from CIM_ResourceAllocationSettingData. 
- 
- 
AddressOnParent 
-  - 
Data type: string 
- 
Access type: Read-only 
 Describes the address of this resource in the context of the parent. The Parent and AddressOnParent properties are used to describe the controller relationship as well as the ordering of devices on a controller. This property is inherited from CIM_ResourceAllocationSettingData. 
- 
- 
AllocationUnits 
-  - 
Data type: string 
- 
Access type: Read-only 
 The unit of allocation used by the Reservation and Limit properties. This property is inherited from CIM_ResourceAllocationSettingData. 
- 
- 
AutomaticAllocation 
-  - 
Data type: boolean 
- 
Access type: Read-only 
 Indicates whether the resource will be automatically allocated. This property is inherited from CIM_ResourceAllocationSettingData. 
- 
- 
AutomaticDeallocation 
-  - 
Data type: boolean 
- 
Access type: Read-only 
 Indicates whether the resource will be automatically deallocated. This property is inherited from CIM_ResourceAllocationSettingData. 
- 
- 
Caption 
-  - 
Data type: string 
- 
Access type: Read-only 
- 
Qualifiers: MaxLen (64) 
 A short description of the object. This property is inherited from CIM_ManagedElement, and it is always set to "Ethernet Switch Port Settings". 
- 
- 
CompartmentGuid 
-  - 
Data type: string 
- 
Access type: Read/write 
 This property specifies the target network compartment for the port. It is only supported for internal adapters. Note Property added in Windows 10. 
- 
- 
Connection 
-  - 
Data type: string array 
- 
Access type: Read-only 
 The device to which this resource is connected. This property is inherited from CIM_ResourceAllocationSettingData. 
- 
- 
ConsumerVisibility 
-  - 
Data type: uint16 
- 
Access type: Read-only 
 The consumer's visibility to the allocated resource. 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. This property is inherited from CIM_ManagedElement, and it is always set to "Ethernet Switch Port Settings". 
- 
- 
DesiredVLANEndpointMode 
-  - 
Data type: uint16 
- 
Access type: Read-only 
 The desired configuration mode for the VLAN endpoint. This property is used to set the initial OperationalEndpointMode property value in the instance of Msvm_VLANEndpoint class associated with the targeted Ethernet port. See the OperationalEndpointMode property of the Msvm_VLANEndpoint class for possible values. This property is inherited from CIM_EthernetPortAllocationSettingData. 
- 
- 
ElementName 
-  - 
Data type: string 
- 
Access type: Read-only 
 A display name for the object. This property is inherited from CIM_SettingData. Changing this property will change the element name of the associated logical device derivative. 
- 
- 
EnabledState 
-  - 
Data type: uint16 
- 
Access type: Read-only 
 Indicates whether the allocation request is enabled or disabled. When an allocation request is marked as Disabled (3), then the allocation is not processed. The EnabledState for an active configuration is always marked as Enabled (2). 
- 
- 
Enabled (2) 
- 
Disabled (3) 
HostResource
- 
Data type: string array 
- 
Access type: Read-only 
Only one host resource can be assigned to each device in the virtual switch, so only the first element of this array can be set. For devices that support this feature, set the first element of the HostResource array to contain a reference to the underlying host resource to be assigned. This property is inherited from CIM_ResourceAllocationSettingData.
InstanceID
- 
Data type: string 
- 
Access type: Read-only 
- 
Qualifiers: Key 
Uniquely identifies an instance of this class. This property is inherited from CIM_SettingData, and it is always set to "Microsoft:GUID\DeviceSpecificData".
LastKnownSwitchName
- 
Data type: string 
- 
Access type: Read-only 
The last known friendly name of the switch this port had a hard affinity to, if any.
Note
Property added in Windows 10.
Limit
- 
Data type: uint64 
- 
Access type: Read-only 
The maximum amount of corresponding host resources that can be consumed by the virtual switch. This property is inherited from CIM_ResourceAllocationSettingData.
MappingBehavior
- 
Data type: uint16 
- 
Access type: Read-only 
Specifies how this resource maps to underlying resources. This property is inherited from CIM_ResourceAllocationSettingData.
OtherEndpointMode
- 
Data type: string 
- 
Access type: Read-only 
A string that describes the type of VLAN endpoint model that is supported by this VLAN endpoint. This property is only used when the DesiredVLANEndpointMode property is set to 1 (Other). This property should be set to Null when the DesiredVLANEndpointMode property is any value other than 1. This property is inherited from CIM_EthernetPortAllocationSettingData.
OtherResourceType
- 
Data type: string 
- 
Access type: Read-only 
A string that describes the resource type when a well-defined value is not available and ResourceType has the value 1 (Other). 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. This property is inherited from CIM_ResourceAllocationSettingData.
PoolID
- 
Data type: string 
- 
Access type: Read-only 
The identifier of the resource pool from which this resource was allocated. This property is inherited from CIM_ResourceAllocationSettingData.
RequiredFeatureHints
- 
Data type: string array 
- 
Access type: Read-only 
The list of display names that correspond to each entry in the RequiredFeatures array.
RequiredFeatures
- 
Data type: string array 
- 
Access type: Read/write 
The list of feature identifiers that represent all the features that are required for a port.
Reservation
- 
Data type: uint64 
- 
Access type: Read-only 
The amount of resources that are reserved for use by the virtual switch. This property is inherited from CIM_ResourceAllocationSettingData.
ResourceSubType
- 
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. This property is inherited from CIM_ResourceAllocationSettingData.
ResourceType
- 
Data type: uint16 
- 
Access type: Read-only 
The type of resource this allocation setting represents. This property is inherited from CIM_ResourceAllocationSettingData, and it is always set to 33 (Ethernet connection).
TestReplicaPoolID
- 
Data type: string 
- 
Access type: Read/write 
Specifies the network resource pool from which a connection will be allocated to the test replica system when it is created.
TestReplicaSwitchName
- 
Data type: string 
- 
Access type: Read/write 
Specifies the display name of the virtual network switch to which a connection will be allocated for the test replica system when it is created.
VirtualQuantity
- 
Data type: uint64 
- 
Access type: Read-only 
The total number of ports in the virtual switch. This property is inherited from CIM_ResourceAllocationSettingData.
VirtualQuantityUnits
- 
Data type: string 
- 
Access type: Read-only 
Specifies the unit of measurement for the VirtualQuantity property. 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. This property is inherited from CIM_ResourceAllocationSettingData.
Weight
- 
Data type: uint32 
- 
Access type: Read-only 
An integer that defines the weight for each virtual switch. This property is inherited from CIM_ResourceAllocationSettingData.
Range: 0 1000
Requirements
| Requirement | Value | 
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] | 
| Minimum supported server | Windows Server 2012 [desktop apps only] | 
| Namespace | Root\Virtualization\V2 | 
| MOF | 
 | 
| DLL | 
 |