Share via

Msvm_EmulatedEthernetPortSettingData-Klasse

  • Artikel

Stellt den konfigurierten Zustand eines emulierten Ethernet-Adapters dar.

Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EmulatedEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  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;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  boolean StaticMacAddress = TRUE;
  boolean ClusterMonitored = TRUE;
};

Member

Die Msvm_EmulatedEthernetPortSettingData-Klasse verfügt über folgende Membertypen:

Eigenschaften

Die Msvm_EmulatedEthernetPortSettingData-Klasse verfügt über diese Eigenschaften.

Adresse

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Adresse der Ressource. Beispielsweise die MAC-Adresse eines Ethernet-Ports. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Dies ist eine schreibgeschützte Eigenschaft, die jedoch mithilfe der ModifyResourceSettings-Methode der Msvm_VirtualSystemManagementService-Klasse geändert werden kann.

AddressOnParent

Datentyp: string

Zugriffstyp: Schreibgeschützt

Beschreibt die Adresse dieser Ressource im Kontext des übergeordneten Elements. Die Eigenschaften Parent und AddressOnParent werden verwendet, um die Controllerbeziehung sowie die Reihenfolge der Geräte auf einem Controller zu beschreiben. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

AllocationUnits

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die von den Eigenschaften Reservierung und Limit verwendeten Zuordnungseinheiten. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf "Ports" festgelegt.

AutomaticAllocation

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Ressource automatisch zugeordnet wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf True festgelegt.

AutomaticDeallocation

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Zuordnung der Ressource automatisch aufgehoben wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf True festgelegt.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Ethernet-Port" festgelegt.

ClusterMonitored

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Gibt an, ob dieser Ethernet-Adapter von einem Cluster überwacht wird. Diese Eigenschaft ist standardmäßig true, wenn sie nicht konfiguriert ist.

Dies ist eine schreibgeschützte Eigenschaft, die jedoch mithilfe der ModifyResourceSettings-Methode der Msvm_VirtualSystemManagementService-Klasse geändert werden kann.

Windows 8.1: Dieser Wert wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2.

Connection

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Das Ding, mit dem diese Ressource verbunden ist. Beispiel: benanntes Netzwerk oder Switchport. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Dies ist eine schreibgeschützte Eigenschaft, die jedoch mithilfe der ModifyResourceSettings-Methode der Msvm_VirtualSystemManagementService-Klasse geändert werden kann.

ConsumerVisibility

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Beschreibt die Sichtbarkeit von Consumern für die zugeordnete Ressource. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und immer auf 3 (virtualisiert) festgelegt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Einstellungen für den emulierten Microsoft-Ethernet-Port" festgelegt.

DesiredVLANEndpointMode

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der gewünschte Konfigurationsmodus für den VLAN-Endpunkt. Diese Eigenschaft wird verwendet, um den anfänglichen OperationalEndpointMode-Eigenschaftswert im instance der Msvm_VLANEndpoint Klasse festzulegen, die dem Ziel-Ethernet-Port zugeordnet ist. Mögliche Werte finden Sie in der OperationalEndpointMode-Eigenschaft der Msvm_VLANEndpoint-Klasse . Diese Eigenschaft wird von CIM_EthernetPortAllocationSettingData geerbt.

ElementName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der vom Benutzer konfigurierbare Anzeigename für das Gerät, dem dieser RASD-instance zugeordnet ist. Diese Eigenschaft wird von CIM_SettingData geerbt und auf "Ethernet-Port" festgelegt. Wenn Sie diese Eigenschaft ändern, wird der Elementname der zugeordneten logischen Geräteableitung geändert.

Dies ist eine schreibgeschützte Eigenschaft, die jedoch mithilfe der ModifyResourceSettings-Methode der Msvm_VirtualSystemManagementService-Klasse geändert werden kann.

HostResource

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf Null festgelegt.

InstanceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Innerhalb des Bereichs des instanziierenden Namespace identifiziert InstanceID einen instance dieser Klasse undurchsichtig und eindeutig. Diese Eigenschaft wird von CIM_SettingData geerbt und ist immer auf "Microsoft:VMID\VDID\device-specific-data" festgelegt.

Begrenzung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Obergrenze oder die maximale Menge der Ressource, die für diese Zuordnung gewährt wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und immer auf 1 festgelegt.

MappingBehavior

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt an, wie diese Ressource zugrunde liegenden Ressourcen zugeordnet wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf Null festgelegt.

OtherEndpointMode

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den Typ des VLAN-Endpunktmodells beschreibt, das von diesem VLAN-Endpunkt unterstützt wird. Diese Eigenschaft wird nur verwendet, wenn die DesiredVLANEndpointMode-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft sollte auf Null festgelegt werden, wenn die DesiredVLANEndpointMode-Eigenschaft einen anderen Wert als 1 aufweist. Diese Eigenschaft wird von CIM_EthernetPortAllocationSettingData geerbt.

OtherResourceType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den Ressourcentyp beschreibt, wenn kein klar definierter Wert verfügbar ist und ResourceType auf 0 ("Sonstige") festgelegt ist. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und nicht verwendet.

Parent

Datentyp: string

Zugriffstyp: Schreibgeschützt

Das übergeordnete Element der Ressource. Beispielsweise ein Controller für die aktuelle Zuordnung. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

PoolID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Pool, aus dem die Ressource derzeit zugeordnet ist, oder der Pool, aus dem die Ressource zugeordnet wird, wenn die Zuordnung erfolgt. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Reservierung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge der Ressource, die garantiert für diese Zuordnung verfügbar ist. Bei Systemen, die eine zu viele Ressourcenbindung unterstützen, wird dieser Wert in der Regel für die Zulassungskontrolle verwendet, um zu verhindern, dass eine Zuordnung akzeptiert wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und immer auf 1 festgelegt.

ResourceSubType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die einen implementierungsspezifischen Untertyp für diese Ressource beschreibt. Dies kann beispielsweise verwendet werden, um verschiedene Modelle desselben Ressourcentyps zu unterscheiden. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf "Microsoft Emulated Ethernet Port" festgelegt.

ResourceType

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der Typ der Ressource, für die diese Einstellung gilt. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf 10 (Ethernet-Adapter) festgelegt.

StaticMacAddress

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Gibt an, ob eine statische MAC-Adresse verwendet werden soll.

Dies ist eine schreibgeschützte Eigenschaft, die jedoch mithilfe der ModifyResourceSettings-Methode der Msvm_VirtualSystemManagementService-Klasse geändert werden kann.

VirtualQuantity

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge der Ressourcen, die dem Verbraucher zur Auswahl gestellt werden. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und immer auf 1 festgelegt.

VirtualQuantityUnits

Datentyp: string

Zugriffstyp: Schreibgeschützt

Gibt die Maßeinheit für diese Ressourcenzuordnung an. Der Wert dieser Eigenschaft muss ein gesetzlicher Wert des Programmatic Units-Qualifizierers sein, wie in Anhang C.1 von DSP0004 V2.5 oder höher definiert. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Weight

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Eine relative Priorität für diese Zuordnung im Verhältnis zu anderen Zuordnungen aus demselben ResourcePool. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und ist immer auf 0 festgelegt.

Bemerkungen

Der Zugriff auf die Msvm_EmulatedEthernetPortSettingData-Klasse kann durch UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.

Beispiele

Weitere Informationen finden Sie unter Abfragen von Netzwerkobjekten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2012 [nur Desktop-Apps]
Namespace
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData