Msvm_EmulatedEthernetPortSettingData class

Represents the configured state of an emulated Ethernet adapter.

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_EmulatedEthernetPortSettingData : CIM_ResourceAllocationSettingData
{
  string  Caption = "Ethernet Port";
  string  Description = "Settings for the Microsoft Emulated Ethernet Port";
  string  InstanceID = "Microsoft:VMID\VDID\device-specific-data";
  string  ElementName = "Ethernet Port";
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft Emulated Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "Ports";
  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;
  boolean StaticMacAddress = TRUE;
};

Members

The Msvm_EmulatedEthernetPortSettingData class has these types of members:

• Properties

Properties

The Msvm_EmulatedEthernetPortSettingData class has these properties.

Address

Data type: string

Access type: Read-only

Qualifiers:

The address of the resource. For example, the MAC address of a Ethernet port. This property is inherited from CIM_ResourceAllocationSettingData.

This is a read-only property, but it can be changed using the ModifyVirtualSystemResources method of the Msvm_VirtualSystemManagementService class.

AllocationUnits

Data type: string

Access type: Read-only

Qualifiers:

The units of allocation used by the Reservation and Limit properties. This property is inherited from CIM_ResourceAllocationSettingData and is always set to "Ports".

AutomaticAllocation

Data type: boolean

Access type: Read-only

Qualifiers:

Indicates whether the resource will be automatically allocated. This property is inherited from CIM_ResourceAllocationSettingData and is always set to True.

AutomaticDeallocation

Data type: boolean

Access type: Read-only

Qualifiers:

Indicates whether the resource will be automatically deallocated. This property is inherited from CIM_ResourceAllocationSettingData and is always set to True.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

A short textual description (one- line string) of the object. This property is inherited from CIM_ManagedElement and is always set to "Ethernet Port".

Connection

Data type: string array

Access type: Read-only

Qualifiers:

The thing to which this resource is connected. For example, a named network or switch port. This property is inherited from CIM_ResourceAllocationSettingData.

This is a read-only property, but it can be changed using the ModifyVirtualSystemResources method of the Msvm_VirtualSystemManagementService class.

ConsumerVisibility

Data type: uint16

Access type: Read-only

Qualifiers:

Describes the consumers visibility to the allocated resource. This property is inherited from CIM_ResourceAllocationSettingData and is always set to 3 (Virtualized).

Description

Data type: string

Access type: Read-only

A textual description of the object. This property is inherited from CIM_ManagedElement and is always set to "Settings for the Microsoft Emulated Ethernet Port".

ElementName

Data type: string

Access type: Read-only

Qualifiers: Required

The user-configurable friendly name for the device this RASD instance is associated with. This property is inherited from CIM_SettingData and it is set to "Ethernet Port". Changing this property will change the element name of the associated logical device derivative.

This is a read-only property, but it can be changed using the ModifyVirtualSystemResources method of the Msvm_VirtualSystemManagementService class.

HostResource

Data type: string array

Access type: Read-only

Qualifiers: HyperVEmbeddedInstance ("CIM_LogicalDevice")

This property is inherited from CIM_ResourceAllocationSettingData and it is always set to NULL.

InstanceID

Data type: string

Access type: Read-only

Qualifiers: Key

Within the scope of the instantiating namespace, InstanceID opaquely and uniquely identifies an instance of this class. This property is inherited from CIM_SettingData and is always set to "Microsoft:VMID\VDID\device-specific-data".

Limit

Data type: uint64

Access type: Read-only

Qualifiers:

The upper bound, or maximum amount of resource that will be granted for this allocation. This property is inherited from CIM_ResourceAllocationSettingData and is always set to 1.

MappingBehavior

Data type: uint16

Access type: Read-only

Qualifiers:

Specifies how this resource maps to underlying resources. This property is inherited from CIM_ResourceAllocationSettingData and is always set to NULL.

OtherResourceType

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_ResourceAllocationSettingData.ResourceType")

A string that describes the resource type when a well-defined value is not available and ResourceType is set to 0 ("Other"). This property is inherited from CIM_ResourceAllocationSettingData and is not used.

Parent

Data type: string

Access type: Read-only

Qualifiers:

The parent of the resource. For example, a controller for the current allocation. This property is inherited from CIM_ResourceAllocationSettingData.

PoolID

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_ResourcePool.PoolId")

The pool the resource is currently allocated from, or which pool the resource will be allocated from when the allocation occurs. This property is inherited from CIM_ResourceAllocationSettingData.

Reservation

Data type: uint64

Access type: Read-only

Qualifiers:

The amount of resource guaranteed to be available for this allocation. On system which support over-commitment of resources, this value is typically used for admission control to prevent an allocation from being accepted thus preventing starvation. This property is inherited from CIM_ResourceAllocationSettingData and is always set to 1.

ResourceSubType

Data type: string

Access type: Read-only

Qualifiers:

A string that describes an implementation specific sub-type 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 and it is always set to "Microsoft Emulated Ethernet Port".

ResourceType

Data type: uint16

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_ResourceAllocationSettingData.OtherResourceType")

The type of resource this setting applies to. This property is inherited from CIM_ResourceAllocationSettingData and is always set to 10 (Ethernet Adapter).

StaticMacAddress

Data type: boolean

Access type: Read-only

Indicates whether to use a static MAC address.

This is a read-only property, but it can be changed using the ModifyVirtualSystemResources method of the Msvm_VirtualSystemManagementService class.

VirtualQuantity

Data type: uint64

Access type: Read-only

Qualifiers:

The quantity of resources presented to the consumer. This property is inherited from CIM_ResourceAllocationSettingData and is always set to 1.

Weight

Data type: uint32

Access type: Read-only

Qualifiers:

A relative priority for this allocation in relation to other allocations from the same ResourcePool. This property is inherited from CIM_ResourceAllocationSettingData and is always set to 0.

Remarks

Access to the Msvm_EmulatedEthernetPortSettingData class might be restricted by UAC Filtering. For more information, see User Account Control and WMI.

Examples

See Querying Networking Objects.

Requirements

See also

CIM_ResourceAllocationSettingData

CIM_ResourceAllocationSettingData

Networking Classes