Msvm_EmulatedEthernetPortSettingData Klasse

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

Elemente

Die Msvm_EmulatedEthernetPortSettingData-Klasse weist folgende Membertypen auf:

• Eigenschaften

Eigenschaften

Die Msvm_EmulatedEthernetPortSettingData Klasse weist diese Eigenschaften auf.

Adresse

Datentyp: Zeichenfolge

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, kann jedoch mithilfe der ModifyResourceSettings-Methode der Msvm_VirtualSystemManagementService-Klasse geändert werden.

AddressOnParent

Datentyp: Zeichenfolge

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 Anordnung von Geräten auf einem Controller zu beschreiben. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

AllocationUnits

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die Einheiten der Zuordnung, die von den Reservierungs - und Limit-Eigenschaften verwendet werden. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt, und sie wird immer auf "Ports" festgelegt.

AutomaticAllocation

Datentyp: Boole'scher Wert

Zugriffstyp: Schreibgeschützt

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

AutomaticDeallocation

Datentyp: Boole'scher Wert

Zugriffstyp: Schreibgeschützt

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

Beschriftung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

ClusterMonitored

Datentyp: Boole'scher Wert

Zugriffstyp: Schreibgeschützt

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

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

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

Verbindung

Datentyp: string-Array

Zugriffstyp: Schreibgeschützt

Die Sache, mit der diese Ressource verbunden ist. Beispiel: ein benannter Netzwerk- oder Switchport. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

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

ConsumerVisibility

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt, und sie wird immer auf "Einstellungen für den Microsoft Emulated 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 in der Instanz Msvm_VLANEndpoint Klasse festzulegen, die dem zielbezogenen 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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

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

HostResource

Datentyp: string-Array

Zugriffstyp: Schreibgeschützt

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

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Im Bereich des Instanziierungsnamespaces identifiziert InstanceID eine Instanz dieser Klasse undurchsichtig und eindeutig. Diese Eigenschaft wird von CIM_SettingData geerbt, und sie wird immer auf "Microsoft:VMID\VDID\gerätespezifische Daten" festgelegt.

Begrenzung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die obere Grenze oder die maximale Menge der Ressource, die für diese Zuordnung gewährt wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt, und sie wird 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 sie wird immer auf Null festgelegt.

OtherEndpointMode

Datentyp: Zeichenfolge

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 (Other) 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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Eltern

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

PoolID

Datentyp: Zeichenfolge

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 für diese Zuordnung garantierten Ressourcen. Bei Systemen, die eine überlastende Verpflichtung von Ressourcen 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 sie wird immer auf 1 festgelegt.

ResourceSubType

Datentyp: Zeichenfolge

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 sie wird immer auf "Microsoft Emulated Ethernet Port" festgelegt.

Ressourcen-Typ

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

StaticMacAddress

Datentyp: Boole'scher Wert

Zugriffstyp: Schreibgeschützt

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

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

Virtuelle Menge

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

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

VirtualQuantityUnits

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Gibt die Maßeinheit für diese Ressourcenzuordnung an. Der Wert dieser Eigenschaft muss ein gesetzlicher Wert des Qualifizierers programmatischer Einheiten gemäß Anhang C.1 von DSP0004 V2.5 oder höher sein. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Gewicht

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Eine relative Priorität für diese Zuordnung in Bezug auf andere Zuordnungen aus demselben ResourcePool. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt, und sie ist immer auf 0 festgelegt.

Bemerkungen

Der Zugriff auf die Msvm_EmulatedEthernetPortSettingData-Klasse ist möglicherweise durch die UAC-Filterung eingeschränkt. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.

Beispiele

Siehe Abfragen von Netzwerkobjekten.

Anforderungen

Siehe auch

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData