Msvm_GuestServiceInterfaceComponentSettingData-Klasse

Artikel
10/17/2023

Repräsentiert den konfigurierten Zustand der Schnittstellenkomponente für den Gastdienst. Diese Klasse ist von der Klasse CIM_ResourceAllocationSettingData abgeleitet.

Die folgende Syntax entstammt dem MOF-Code, wurde vereinfacht 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 Klasse Msvm_GuestServiceInterfaceComponentSettingData weist die folgenden Arten von Membern auf:

Eigenschaften

Eigenschaften

Die Klasse Msvm_GuestServiceInterfaceComponentSettingData weist die folgenden Eigenschaften auf:

Adresse

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

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

AllocationUnits

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die Einheiten der Zuordnung an, die von den Eigenschaften „Reservation“ und „Limit“ verwendet werden. Beispielsweise kann „AllocationUnits“ im Fall von „ResourceType=Processor“ auf „MHz“ festgelegt werden. Bei „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. Bei Festlegung auf TRUE wird beim Einschalten des virtuellen Computersystems, das als Consumer dient, diese Ressource zugeordnet. Der Wert FALSE gibt an, dass die Ressource explizit zugeordnet werden muss. Die Einstellung kann z. B. für Wechselmedien (d. h. eine CD-ROM oder eine Diskette) verwendet werden, bei denen das Medium zum Zeitpunkt des Einschaltens 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 Zuordnung der Ressource automatisch aufgehoben wird. Bei Festlegung auf TRUE wird beim Ausschalten des virtuellen Computersystems, das als Consumer dient, die Zuordnung dieser Ressource aufgehoben. Bei Festlegung auf FALSE bleibt die Ressource zugeordnet, und die Zuordnung muss explizit aufgehoben werden.

Verbindung

Datentyp: string-Array
Zugriffstyp: Schreibgeschützt

Das Element, mit dem diese Ressource verbunden ist. Dies kann beispielsweise ein benanntes Netzwerk oder ein Switchport sein.

ConsumerVisibility

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Beschreibt die Sichtbarkeit der Consumer für die zugeordnete Ressource.

Wert	Bedeutung
Unbekannt 0	Unbekannt
Übergeben 2	Die zugrunde liegende Ressource bzw. Hostressource wird verwendet und an den Consumer übergeben, möglicherweise mithilfe einer Partitionierung. Mindestens ein Element muss in der Eigenschaft „DeviceID“ vorhanden sein.
Virtualisiert 3	Die Ressource ist virtualisiert und kann nicht direkt einer zugrunde liegenden Ressource oder Hostressource zugeordnet werden. Einige Implementierungen unterstützen möglicherweise bestimmte Zuordnungen für virtualisierte Ressourcen. In diesem Fall werden die Hostressourcen mithilfe der Eigenschaft „DeviceID“ verfügbar gemacht.
Nicht repräsentiert 4	Im Kontext des Ressourcenconsumers ist keine Darstellung der Ressource vorhanden.
Von DMTF reserviert ..
Von Anbieter reserviert 32767..65535

DefaultEnabledStatePolicy

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die standardmäßigen aktivierten und deaktivierten Zustände der Gastkommunikationsdienste.

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

Hinweis

Wurde in Windows 10 hinzugefügt.

Aktiviert (2)

Deaktiviert (3)

ElementName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

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

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktivierten und deaktivierten Zustände eines Elements.

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

Gültige Werte sind:

Aktiviert (2)

Deaktiviert (3)

HostResource

Datentyp: string-Array
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft macht bestimmte Zuordnungen zu Hostressourcen bzw. 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 mit Hostressourcen zu bestimmen, für den diese virtuelle Ressource geplant werden kann. Wenn eine bestimmte Zuordnung verwendet wird, werden alle von dieser virtuellen Ressource verwendeten zugrunde liegenden Ressourcen in diesem Array aufgelistet. In der Regel enthält das Array nur ein Element, bei aggregierten Zuordnungen wie z. B. mehreren Prozessoren können aber auch mehrere Hostressourcen angegeben werden.

InstanceID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Im Bereich des instanziierenden Namespace identifiziert die InstanceID eine Instanz dieser Klasse eindeutig und nicht transparent. Um die Eindeutigkeit innerhalb des Namespace zu gewährleisten, sollte der Wert der InstanceID mithilfe des folgenden „bevorzugten“ Algorithmus erstellt werden: OrgID:LocalID. Dabei sind OrgID und LocalID durch einen Doppelpunkt (:) getrennt, und OrgID muss einen urheberrechtlich geschützten, markengeschützten oder anderweitig eindeutigen Namen enthalten, der im Besitz derjenigen Geschäftsentität ist, die die InstanceID erstellt oder definiert. Der Name kann auch eine registrierte ID sein, die der Geschäftsentität durch eine anerkannte globale Registrierungsstelle zugewiesen ist. (Diese Anforderung ähnelt der SchemaName_ClassName-Struktur von Schemaklassennamen.) Um die Eindeutigkeit zu gewährleisten, darf OrgID außerdem keinen Doppelpunkt (:) enthalten. Bei Verwendung dieses Algorithmus muss sich der erste Doppelpunkt, der in der InstanceID angezeigt wird, zwischen OrgID und LocalID befinden. LocalID wird von der Geschäftsentität ausgewählt und sollte nicht wiederverwendet werden, um unterschiedliche 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 in allen InstanceIDs wiederverwendet wird, die von diesem oder anderen Anbietern für den Namespace dieser Instanz erstellt werden. Bei von DMTF definierten Instanzen muss der „bevorzugte“ Algorithmus verwendet werden, wobei die OrgID auf „CIM“ festgelegt ist.

Grenze

Datentyp: uint64
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die obere Grenze bzw. die maximale Menge der Ressourcen an, die für diese Zuordnung gewährt werden. Ein System, das die Auslagerung von Arbeitsspeicher unterstützt, kann beispielsweise das Festlegen eines Grenzwerts für die Speicherbelegung unterhalb des Grenzwerts für die VirtualQuantity 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 zugeordnet wird. Wenn das HostResource-Array Einträge enthält, gibt diese Eigenschaft an, wie die Ressource diesen spezifischen Ressourcen zugeordnet wird.

Unbekannt (0)
Nicht unterstützt (1)
Dediziert (2)
Weiche Affinität (3)
Harte Affinität (4)
Von DMTF reserviert (..)
Von Anbieter reserviert (32767..65535)

OtherResourceType

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den Ressourcentyp beschreibt, wenn kein gut definierter Wert verfügbar ist und der ResourceType den Wert „Other“ aufweist.

Parent

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

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

PoolID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

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

Reservierung

Datentyp: uint64
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die Menge der für diese Zuordnung garantiert verfügbaren Ressourcen an. In einem System, das eine Überbelegung von Ressourcen unterstützt, wird dieser Wert in der Regel für die Zugangssteuerung verwendet, um eine Ressourcenerschöpfung durch das Akzeptieren einer Ressourcenzuweisung zu verhindern.

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.

ResourceType

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der Typ der Ressource, die diese Zuordnungseinstellung repräsentiert.

Andere (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-Steckplatz (12)
E/A-Gerät (13)
Diskettenlaufwerk (14)
CD-Laufwerk (15)
DVD-Laufwerk (16)
Serieller Anschluss (17)
Paralleler Anschluss (18)
USB-Controller (19)
Grafikcontroller (20)
Speichererweiterung (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)
Von DMTF reserviert (..)
Von Anbieter reserviert (32767..65535)

VirtualQuantity

Datentyp: uint64
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft gibt die Menge an Ressourcen an, die dem Consumer angezeigt werden. Im Fall von „ResourceType=Processor“ beispielsweise spiegelt diese Eigenschaft die Anzahl der diskreten Prozessoren wider, die dem virtuellen Computersystem angezeigt werden. Bei „ResourceType=Memory“ kann diese Eigenschaft die Menge an MB widerspiegeln, die dem virtuellen Computersystem gemeldet wurden.

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 weist keine Maßeinheit auf und ist nur im Vergleich mit anderen Zuordnungen relevant, die dieselben Hostressourcen nutzen.

Anforderungen

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

Siehe auch

CIM_ResourceAllocationSettingData
CIM_ResourceAllocationSettingData

Freigeben über