Msvm _ GuestServiceInterfaceComponentSettingData-Klasse

Stellt den konfigurierten Zustand der Gastdienstschnittstellenkomponente dar. Diese Klasse wird von der _ CIM-Klasse ResourceAllocationSettingData ableiten.

Die folgende Syntax enthält vereinfachten MOF-Code und schließt alle geerbten Eigenschaften ein.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
  string  ElementName;
  string  InstanceID;
  uint16  ResourceType;
  string  OtherResourceType;
  string  ResourceSubType;
  string  PoolID;
  uint16  ConsumerVisibility;
  string  HostResource[];
  string  AllocationUnits;
  uint64  VirtualQuantity;
  uint64  Reservation;
  uint64  Limit;
  uint32  Weight;
  boolean AutomaticAllocation;
  boolean AutomaticDeallocation;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  uint16  EnabledState = 3;
  uint16  DefaultEnabledStatePolicy = 2;
};

Member

Die Msvm _ GuestServiceInterfaceComponentSettingData-Klasse verfügt über die folgenden Membertypen:

Eigenschaften

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

Adresse

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Adresse der Ressource. Beispiel: die MAC-Adresse eines Ethernet-Ports.

AllocationUnits

Datentyp: string

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die Zuordnungseinheiten an, die von den Eigenschaften Reservierung und Limit verwendet werden. Wenn beispielsweise ResourceType=Processor, kann AllocationUnits auf MHz festgelegt werden. Wenn ResourceType=Memory, kann AllocationUnits auf MB festgelegt werden.

AutomaticAllocation

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt an, ob die Ressource automatisch zugeordnet wird. Wenn sie beispielsweise auf TRUE festgelegt ist, wird diese Ressource zugeordnet, wenn das systemaufwändige virtuelle Computer eingeschaltet ist. Der Wert false gibt an, dass die Ressource explizit zugeordnet werden muss. Die Einstellung kann z. B. Wechselmedien (d. h. Zung oder Diskette) darstellen, bei denen das Medium bei der Energieversorgung nicht vorhanden ist. Zum Zuordnen der Ressource ist ein expliziter Vorgang erforderlich.

AutomaticDeallocation

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt an, ob die Ressourcenzuordnung automatisch entfernt wird. Wenn sie z. B. auf TRUE festgelegt ist, wird die Ressourcenzuordnung bei ausgeschalteten virtuellen Computersystemen wieder eingestellt. Wenn false festgelegt ist, bleibt die Ressource zugeordnet und muss explizit wieder zugeordnet werden.

Connection

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Das, mit dem diese Ressource verbunden ist. Beispielsweise ein benanntes Netzwerk oder ein Switchport.

ConsumerVisibility

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Beschreibt die Sichtbarkeit des Consumers für die zugeordnete Ressource.

Wert Bedeutung
Unbekannt
0
Unbekannt
Übergebene Durch übergebene
2
Die zugrunde liegende - oder -Hostressource wird verwendet und an den Consumer übergeben, möglicherweise mithilfe der Partitionierung. In der DeviceID-Eigenschaft muss mindestens ein Element vorhanden sein.
Virtualisiert
3
Die Ressource wird virtualisiert und ist möglicherweise nicht direkt einer zugrunde liegenden/Hostressource zuordnen. Einige Implementierungen unterstützen möglicherweise eine bestimmte Zuweisung für virtualisierte Ressourcen. In diesem Fall werden die Hostressourcen mithilfe der DeviceID-Eigenschaft verfügbar gemacht.
Nicht dargestellt
4
Eine Darstellung der Ressource ist im Kontext des Ressourcenverbraucher nicht vorhanden.
RESERVIERTE
DMTF-Datei.
Anbieter reserviert
32767..65535

DefaultEnabledStatePolicy

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der aktivierte und deaktivierte Zustände von Gastkommunikationsdiensten standardmäßig.

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

Hinweis

Hinzugefügt in Windows 10.

Aktiviert (2)

Deaktiviert (3)

ElementName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Anzeigename für diese Instanz von SettingData. Darüber hinaus kann der Anzeigename als Indexeigenschaft für eine Suche oder Abfrage verwendet werden. (Hinweis: Der Name muss innerhalb eines Namespaces nicht eindeutig sein.)

EnabledState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der aktivierte und deaktivierte Zustände eines Elements.

Dies ist eine schreibgeschützte Eigenschaft, die jedoch mithilfe der ModifyVirtualSystemResources-Methode (oder ModifyResourceSettings in Windows 10 oder höher) der Msvm _ VirtualSystemManagementService-Klasse geändert werden kann.

Gültige Werte sind:

Aktiviert (2)

Deaktiviert (3)

HostResource

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft macht eine bestimmte Zuweisung zum Hosten oder zu zugrunde liegenden Ressourcen verfügbar. Die eingebetteten Instanzen dürfen nur Schlüsseleigenschaften enthalten und als Objektpfade behandelt werden. Wenn die virtuelle Ressource für eine Reihe von zugrunde liegenden Ressourcen geplant werden kann, sollte diese Eigenschaft NULL bleiben. In diesem Fall können die Zuordnungen DeviceAllocatedFromPool oder ResourceAllocationFromPool verwendet werden, um den Pool von Hostressourcen zu bestimmen, für den diese virtuelle Ressource geplant werden kann. Wenn eine bestimmte Zuweisung verwendet wird, müssen alle zugrunde liegenden Ressourcen, die von dieser virtuellen Ressource verwendet werden, in diesem Array aufgeführt werden. In der Regel enthält das Array ein Element. Für Aggregatzuordnungen, z. B. mehrere Prozessoren, können jedoch mehrere Hostressourcen angegeben werden.

InstanceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Im Gültigkeitsbereich des instanziierenden Namespace identifiziert InstanceID eine Instanz dieser Klasse undurchsichtig und eindeutig. Um die Eindeutigkeit innerhalb des NameSpace sicherzustellen, sollte der Wert von InstanceID mit dem folgenden "bevorzugten" Algorithmus erstellt werden: OrgID:LocalID, wobei OrgID und LocalID durch einen Doppelpunkt (:)) getrennt sind und wobei OrgID einen urheberrechtlich geschützten, markengebundenen oder anderweitig eindeutigen Namen enthalten muss, der im Besitz der Geschäftseinheit ist, die die InstanceID erstellt oder definiert oder eine registrierte ID ist, die der Geschäftseinheit von einer anerkannten globalen Autorität zugewiesen wurde. (Diese Anforderung ähnelt schemaName. _ ClassName-Struktur von Schemaklassennamen.) Um die Eindeutigkeit sicherzustellen, darf OrgID außerdem keinen Doppelpunkt (:). Bei Verwendung dieses Algorithmus muss der erste Doppelpunkt, der in InstanceID angezeigt wird, zwischen OrgID und LocalID angezeigt werden. LocalID wird von der Geschäftsentität ausgewählt und sollte nicht wiederverwendet werden, um verschiedene zugrunde liegende (reale) Elemente zu identifizieren. Wenn der oben genannte "bevorzugte" Algorithmus nicht verwendet wird, muss die definierende Entität sicherstellen, dass die resultierende InstanceID nicht für InstanceIDs wiederverwendet wird, die von diesem oder anderen Anbietern für den NameSpace dieser Instanz erzeugt werden. Für DMTF-definierte Instanzen muss der "bevorzugte" Algorithmus verwendet werden, und die OrgID muss auf CIM festgelegt sein.

Begrenzung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die Obergrenze oder die maximale Menge an Ressourcen an, die für diese Zuordnung gewährt werden. Beispielsweise kann ein System, das Speicher paging unterstützt, das Festlegen des Grenzwerts für eine Speicherzuweisung unterhalb des VirtualQuantity-Grenzwerts unterstützen, wodurch die Auslagerung für diese Zuordnung erzwungen wird.

MappingBehavior

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt an, wie diese Ressource zugrunde liegenden Ressourcen zu ordnet. Wenn das HostResource-Array Einträge enthält, spiegelt diese Eigenschaft wider, wie die Ressource diesen spezifischen Ressourcen entspricht.

Unbekannt (0)

Nicht unterstützt (1)

Dedicated (2)

Soft Affinity (3)

Hard Affinity (4)

DMTF Reserved (..)

Reservierter Anbieter (32767..65535)

OtherResourceType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den Ressourcentyp beschreibt, wenn ein klar definierter Wert nicht verfügbar ist und ResourceType den Wert "Other" hat.

Parent

Datentyp: string

Zugriffstyp: Schreibgeschützt

Das übergeordnete Element der Ressource. Beispiel: ein Controller für die aktuelle Zuordnung.

PoolID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt an, aus welchem ResourcePool die Ressource derzeit zugeordnet ist oder von welchem ResourcePool die Ressource zugeordnet wird, wenn die Zuordnung erfolgt.

Reservierung

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die Menge der Ressource an, die für diese Zuordnung garantiert verfügbar ist. Auf einem System, das eine überzubelegung von Ressourcen unterstützt, wird dieser Wert in der Regel für die Zugangssteuerung verwendet, um zu verhindern, dass eine Zuordnung akzeptiert wird, wodurch eine Ressourcenaufbelegung verhindert wird.

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.

ResourceType

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der Ressourcentyp, den diese Zuordnungseinstellung darstellt.

Sonstige (1)

Computersystem (2)

Prozessor (3)

Arbeitsspeicher (4)

IDE-Controller (5)

Paralleler SCSI-HBA (6)

FC HBA (7)

iSCSI HBA (8)

IB HCA (9)

Ethernet-Adapter (10)

Anderer Netzwerkadapter (11)

E/A-Slot (12)

E/A-Gerät (13)

Diskettenlaufwerk (14)

CD-Laufwerk (15)

DVD-Laufwerk (16)

Serieller Anschluss (17)

Paralleler Port (18)

USB-Controller (19)

Grafikcontroller (20)

Storage Extent (21)

Datenträger (22)

Band (23)

Anderes Speichergerät (24)

Firewire Controller (25)

Partitionierbare Einheit (26)

Partitionierbare Basiseinheit (27)

Stromversorgung (28)

Kühlgerät (29)

DMTF reserved (.)

Reservierter Anbieter (32767..65535)

VirtualQuantity

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die Menge der Ressourcen an, die dem Consumer präsentiert werden. Wenn beispielsweise ResourceType=Processor verwendet wird, spiegelt diese Eigenschaft die Anzahl der diskreten Prozessoren wider, die dem virtuellen Computersystem präsentiert werden. Wenn ResourceType=Memory, könnte diese Eigenschaft die Anzahl von MB widerspiegeln, die an das virtuelle Computersystem gemeldet werden.

Weight

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt eine relative Priorität für diese Zuordnung in Bezug auf andere Zuordnungen aus demselben ResourcePool an. Diese Eigenschaft verfügt über keine Maßeinheit und ist nur relevant im Vergleich zu anderen Zuordnungen, die um die gleichen Hostressourcen konkurrieren.

Anforderungen

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

Siehe auch

CIM _ ResourceAllocationSettingData

CIM _ ResourceAllocationSettingData