Msvm _ SyntheticEthernetPortSettingData-Klasse

Stellt den konfigurierten Zustand eines synthetischen Ethernet-Adapters dar.

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

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

Member

Die Msvm _ SyntheticEthernetPortSettingData-Klasse verfügt über diese Typen von Membern:

Eigenschaften

Die Msvm _ SyntheticEthernetPortSettingData-Klasse verfügt über diese Eigenschaften.

Adresse

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Adresse der Ressource. Beispielsweise die MAC-Adresse eines Ethernetports. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

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 _ ResourceAllocationSettingDatageerbt.

AllocationUnits

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Zuordnungseinheiten, die von den Eigenschaften Reservierung und Limit verwendet werden. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

AllowPacketDirect

Datentyp: boolescher Wert

Zugriffstyp: Lesen/Schreiben

Gibt an, ob die PacketDirect-Projektion für den virtuellen Computer aktiviert ist.

Hinweis

In Windows 10 Version 1703 und Windows Server 2016 hinzugefügt.

AutomaticAllocation

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Ressource automatisch zugeordnet wird. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

AutomaticDeallocation

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Zuordnung der Ressource automatisch freigegeben wird. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des -Objekts. Diese Eigenschaft wird von CIM _ ManagedElementgeerbt.

ClusterMonitored

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob dieser Ethernetadapter von einem Cluster überwacht wird. Diese Eigenschaft ist standardmäßig auf TRUE eingestellt, 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 Windows 8.1 und Windows Server 2012 R2 unterstützt.

Connection

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Das, mit dem diese Ressource verbunden ist. Beispielsweise ein benannter Netzwerk- oder Switchport. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

ConsumerVisibility

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die Sichtbarkeit der Consumer für die zugeordnete Ressource. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt und immer auf 3 (virtualisiert) festgelegt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM _ ManagedElementgeerbt.

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 der Msvm _ VLANEndpoint-Klasse festzulegen, die dem Ziel-Ethernetport zugeordnet ist. Mögliche Werte finden Sie in der OperationalEndpointMode-Eigenschaft der Msvm _ VLANEndpoint-Klasse. Diese Eigenschaft wird von CIM _ EthernetPortAllocationSettingData geerbt.

DeviceNamingEnabled

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob dieser Ethernetadapter die Gerätebenennung unterstützt.

Dies ist eine schreibgeschützte Eigenschaft, die jedoch mit der ModifyVirtualSystemResources-Methode der Msvm _ VirtualSystemManagementService-Klasse geändert werden kann.

Hinweis

In Windows 10 und Windows Server 2016 hinzugefügt.

ElementName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des -Objekts. Diese Eigenschaft wird von CIM _ SettingDatageerbt.

HostResource

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt und immer auf NULL festgelegt.

InstanceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert eine Instanz dieser Klasse eindeutig. Diese Eigenschaft wird von CIM _ ManagedElementgeerbt.

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 _ ResourceAllocationSettingDatageerbt.

MappingBehavior

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt an, wie diese Ressource zugrunde liegenden Ressourcen zugeordnet wird. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

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 (Other) festgelegt ist. Diese Eigenschaft sollte auf NULL festgelegt werden, wenn die DesiredVLANEndpointMode-Eigenschaft ein anderer Wert als 1 ist. 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 "Other" (0) festgelegt ist. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt 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 _ ResourceAllocationSettingDatageerbt.

PoolID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Pool, aus dem die Ressource derzeit zugeordnet ist, oder aus welchem Pool die Ressource zugeordnet wird, wenn die Zuordnung erfolgt. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

Reservierung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge der Ressource, die für diese Zuordnung garantiert verfügbar ist. Auf Systemen, die übermäßig viele Ressourcen unterstützen, wird dieser Wert in der Regel für die Zugangssteuerung verwendet, um zu verhindern, dass eine Zuordnung akzeptiert wird. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

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 _ ResourceAllocationSettingDatageerbt.

ResourceType

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

StaticMacAddress

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob die MAC-Adresse statisch ist.

VirtualQuantity

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge der Ressourcen, die dem Consumer angezeigt werden. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

VirtualQuantityUnits

Datentyp: string

Zugriffstyp: Schreibgeschützt

Gibt die Maßeinheit für die VirtualQuantity-Eigenschaft an. Der Wert dieser Eigenschaft muss ein rechtlicher Wert des Qualifizierers "Programmgesteuerte Einheiten" sein, wie in Anhang C.1 von DSP0004 V2.5 oder höher definiert. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

VirtualSystemIdentifiers

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Qualifizierer: ArrayType ("Indiziert")

Ein Zeichenfolgenarray mit Bezeichnern dieser Ressource, das dem Betriebssystem des virtuellen Computers angezeigt wird. Die Indizes und Werte pro Index werden pro Ressource definiert (d. amp;n.b. für jeden aufzähligen ResourceType-Eigenschaftswert).

Weight

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Eine relative Priorität für diese Zuordnung im Verhältnis zu anderen Zuordnungen aus demselben Ressourcenpool. Diese Eigenschaft wird von CIM _ ResourceAllocationSettingDatageerbt.

Hinweise

Der Zugriff auf die Msvm _ SyntheticEthernetPortSettingData-Klasse kann durch die 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