Freigeben über

Msvm_SyntheticEthernetPortSettingData-Klasse

  • Artikel

Stellt den konfigurierten Zustand eines synthetischen 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_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 die folgenden Membertypen:

Eigenschaften

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

Adresse

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

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

AllocationUnits

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die von den Eigenschaften Reservierung und Limit verwendeten Zuordnungseinheiten. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

AllowPacketDirect

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

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: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Ressource automatisch zugeordnet wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

AutomaticDeallocation

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Ressource automatisch zugeordnet wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

ClusterMonitored

Datentyp: Boolesch

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, 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 Ding, mit dem diese Ressource verbunden ist. Beispielsweise ein benanntes Netzwerk oder switch-Port. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

ConsumerVisibility

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die Consumer sind für die zugeordnete Ressource sichtbar. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und immer auf 3 (virtualisiert) festgelegt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

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.

DeviceNamingEnabled

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob dieser Ethernet-Adapter die Gerätebenennung unterstützt.

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

Hinweis

In Windows 10 und Windows Server 2016 hinzugefügt.

ElementName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_SettingData geerbt.

HostResource

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

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

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

Begrenzung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Obergrenze oder die maximale Ressourcenmenge, die für diese Zuordnung gewährt wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

MappingBehavior

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt an, wie diese Ressource zugrunde liegenden Ressourcen zugeordnet wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

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

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_ResourceAllocationSettingData geerbt und nicht verwendet.

Parent

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 zugewiesen wird, oder der Pool, aus dem die Ressource zugewiesen wird, wenn die Zuordnung erfolgt. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Reservierung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge an Ressourcen, die für diese Zuordnung garantiert verfügbar ist. Auf Systemen, die eine übermäßige Ressourcenbindung unterstützen, wird dieser Wert in der Regel für die Zulassungssteuerung verwendet, um zu verhindern, dass eine Zuordnung akzeptiert wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

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.

ResourceType

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

StaticMacAddress

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob die MAC-Adresse statisch ist.

VirtualQuantity

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge der Ressourcen, die dem Verbraucher angezeigt werden. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

VirtualQuantityUnits

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

VirtualSystemIdentifiers

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Qualifizierer: ArrayType ("Indexed")

Ein Zeichenfolgenarray von Bezeichnern dieser Ressource, das dem Betriebssystem des virtuellen Computers angezeigt wird. Die Indizes und Werte pro Index werden auf Ressourcenbasis (d. a. für jeden aufgezählten ResourceType-Eigenschaftswert ) definiert.

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_ResourceAllocationSettingData geerbt.

Bemerkungen

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
 Stamm\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData