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