Msvm_SyntheticEthernetPortSettingData Klasse

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 weist folgende Arten von Membern auf:

Eigenschaften

Die Msvm_SyntheticEthernetPortSettingData 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.

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 Eigenschaften "Reservierung " und "Limit " verwendet werden. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

AllowPacketDirect

Datentyp: boolescher Datentyp

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: boolescher Datentyp

Zugriffstyp: Schreibgeschützt

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

AutomaticDeallocation

Datentyp: boolescher Datentyp

Zugriffstyp: Schreibgeschützt

Gibt an, ob die Ressource automatisch umgeglichen 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: boolescher Datentyp

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 unterstützt, wenn Windows 8.1 und Windows Server 2012 R2.

Connection

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

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

ConsumerVisibility

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die Verbraucher sind für die zugeordnete Ressource sichtbar. 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.

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

DeviceNamingEnabled

Datentyp: boolescher Datentyp

Zugriffstyp: Schreibgeschützt

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

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

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 sie wird immer auf Null festgelegt.

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert eine Instanz dieser Klasse eindeutig. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

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.

MappingBehavior

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt an, wie diese Ressource den 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 (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 "Other" (0) festgelegt ist. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt und wird 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, von dem die Ressource derzeit zugewiesen wird, oder von welchem Pool die Ressource zugewiesen wird, wenn die Zuordnung auftritt. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Reservierung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge der Ressource, die für diese Zuordnung garantiert verfügbar ist. Bei Systemen, die die Überbindung 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.

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 Typ der Ressource, auf die diese Einstellung angewendet wird. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt, und sie wird immer auf 10 (Ethernet Adapter) festgelegt.

StaticMacAddress

Datentyp: boolescher Datentyp

Zugriffstyp: Schreibgeschützt

Gibt an, ob die MAC-Adresse statisch ist.

VirtualQuantity

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Menge der Ressourcen, die dem Verbraucher präsentiert 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 rechtlicher 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.

VirtualSystemIdentifiers

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Qualifizierer: ArrayType ("Indexed")

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

Weight

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Eine relative Priorität für diese Zuordnung in Bezug auf andere Zuordnungen aus demselben Ressourcenpool. Diese Eigenschaft wird von CIM_ResourceAllocationSettingData geerbt.

Bemerkungen

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

Beispiele

Siehe Abfragen von Netzwerkobjekten.

Requirements (Anforderungen)

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

Siehe auch

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData