Msvm_PlannedComputerSystem-Klasse

Artikel
06/12/2023

Stellt einen geplanten virtuellen Computer dar.

Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_PlannedComputerSystem : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Planned Virtual Machine";
  string   Description = "Microsoft Planned Virtual Machine";
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The service is running normally" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState = 12;
  string   CreationClassName;
  string   Name;
  string   NameFormat;
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability;
  uint16   PowerManagementCapabilities[];
  uint16   AssignedNumaNodeList[];
  uint64   OnTimeInMilliseconds;
  uint32   ProcessID;
  datetime TimeOfLastConfigurationChange;
};

Member

Die Msvm_PlannedComputerSystem-Klasse verfügt über folgende Membertypen:

Methoden
Eigenschaften

Methoden

Die Msvm_PlannedComputerSystem-Klasse verfügt über diese Methoden.

Methode	Beschreibung
RequestStateChange	Fordert an, dass der Zustand des geplanten Systems in den angegebenen Wert geändert wird.
SetPowerState	Diese Methode wird nicht unterstützt.

Eigenschaften

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

AssignedNumaNodeList

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt
Qualifizierer: ArrayType ("indiziert")

Ein Array von NUMA-Knoten (Nonuniform Memory Access), die dem virtuellen Computer derzeit zugewiesen sind.

AvailableRequestedStates

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestedState-Parameter der RequestStateChange-Methode an, die zum Initiieren einer Zustandsänderung verwendet wird. Die aufgeführten Werte sind eine Teilmenge der Werte, die in der RequestedStatesSupported-Eigenschaft der zugeordneten instance von CIM_EnabledLogicalElementCapabilities enthalten sind, wobei die ausgewählten Werte eine Funktion des aktuellen Zustands des CIM_EnabledLogicalElement-Objekts sind. Diese Eigenschaft kann nicht NULL sein, wenn eine Implementierung den Satz möglicher Werte als Funktion des aktuellen Zustands ankündigen kann. Diese Eigenschaft ist NULL , wenn eine Implementierung den Satz möglicher Werte nicht als Funktion des aktuellen Zustands ermitteln kann.

Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Aktiviert (2)
Deaktiviert (3)
Herunterfahren (4)
Offline (6)
Test (7)
Zurückstellen (8)
Stilllegen (9)
Neustart (10)
Zurücksetzen (11)
DMTF Reserviert (.. )

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Geplante virtueller Computer" festgelegt.

CommunicationStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die Fähigkeit der Instrumentierung an, mit dem zugrunde liegenden verwalteten Element zu kommunizieren. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

CreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Gibt den Namen der Klasse oder der Unterklasse an, die bei der Erstellung einer instance verwendet wurde. Bei Verwendung mit den anderen Schlüsseleigenschaften dieser Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen. Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

Dediziert

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Ein Array von Werten, die angeben, für welche Zwecke das geplante System dediziert wird, falls vorhanden, und welche Funktionalität bereitgestellt wird. Beispielsweise könnte angegeben werden, dass das System "Print" (Wert=11) zugeordnet ist oder als "Hub" (Wert=8) fungiert. Es können auch mehrere Zwecke angegeben werden. Dies ist beispielsweise ein universelles System, das "Not Dedicated" (value=0) angibt, aber auch Dienste vom Typ "Print" (Wert=11) oder "Mobiles Benutzergerät" (Wert=17) hostet.

Diese Eigenschaft wird von der CIM_ComputerSystem-Klasse geerbt.

Wert	Bedeutung
Nicht dediziert 0
Unbekannt 1
Andere 2
Storage 3
Router 4
Switch 5
Layer 3 Switch 6
Central Office Switch 7
Hub 8
Access Server 9
Firewall 10
Drucken 11
E/A 12
Webzwischenspeicherung 13
Verwaltung 14	Gibt an, dass dieser instance für das Hosten von Systemverwaltungssoftware vorgesehen ist.
Blockserver 15
Dateiserver 16
Mobiles Benutzergerät 17	Ein Beispiel für ein dediziertes mobiles Benutzergerät ist ein Mobiltelefon oder ein Barcodescanner in einem Geschäft, der über Funkfrequenz kommuniziert. Diese Systeme sind hinsichtlich Funktionalität und Programmierbarkeit recht eingeschränkt und gelten nicht als allgemeine Computingplattformen. Alternativ ist ein Beispiel für ein mobiles System, das universell ist (d. h. NICHT dediziert ist), ein handgehaltener Computer. Obwohl die Programmierbarkeit eingeschränkt ist, kann neue Software heruntergeladen und ihre Funktionalität vom Benutzer erweitert werden.
Repeater 18
Bridge/Extender 19
Gateway 20
Storage Virtualizer 21
Medienbibliothek 22
ExtenderNode 23
NAS-Kopf 24
Eigenständiges NAS 25
USV 26
IP-Telefon 27
Verwaltungscontroller 28	Gibt an, dass diese instance spezialisierte Hardware darstellt, die für die Systemverwaltung (d. a. einen Baseboard Management Controller (BMC) oder einen Dienstprozessor) vorgesehen ist. Der Verwaltungsbereich eines Verwaltungscontrollers ist in der Regel ein einzelnes verwaltetes System, in dem er enthalten ist.
Gehäuse-Manager 29	Gibt an, dass dieser instance ein System darstellt, das für die Verwaltung eines Blattgehäuses und seiner enthaltenen Geräte vorgesehen ist. Dieser Wert wird verwendet, um einen Shelf Controller darzustellen. Ein Gehäuse-Manager ist ein Aggregationspunkt für die Verwaltung und kann sich auf untergeordnete Verwaltungscontroller für die Verwaltung von Komponenten stützen.
Hostbasierter RAID-Controller 30	Gibt an, dass dieser instance einen RAID-Speichercontroller darstellt, der in einem Hostcomputer enthalten ist.
Speichergerätegehäuse 31	Gibt an, dass dieser instance ein Gehäuse darstellt, das Speichergeräte enthält.
Desktop 32
Laptop 33
Virtuelle Bandbibliothek 34	Die Emulation einer Bandbibliothek durch ein virtuelles Bibliothekssystem.
Virtuelles Bibliothekssystem 35	Verwendet Datenträgerspeicher zum Emulieren von Bandbibliotheken.
Netzwerk-PC/Thin Client 36
FC Switch 37	Gibt an, dass diese instance für das Wechseln von Fibre Channel-Frames der Ebene 2 vorgesehen ist.
Ethernet-Switch 38	Gibt an, dass dieser instance für das Wechseln von Layer-2-Ethernet-Frames vorgesehen ist.
DMTF Reserviert 39..32567
Anbieter reserviert 32568..65535

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Microsoft Planned Virtual Machine" festgelegt.

DetailedStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft mit zusätzlichen status Details. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ElementName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

EnabledDefault

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die Standard- oder Startkonfiguration eines Administrators für den aktivierten Status eines Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und kann einer der folgenden Werte sein.

Wert	Bedeutung
Disabled 3	Das System ist deaktiviert.
Aktiviert, aber offline 6	Das System ist aktiviert, aber offline. Alle neuen Anforderungen werden gelöscht.

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt den aktivierten Zustand des geplanten Systems an. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und kann einer der folgenden Werte sein.

Wert	Bedeutung
Disabled 3	Das System ist deaktiviert.
Aktiviert, aber offline 6	Das System ist aktiviert, aber offline. Alle neuen Anforderungen werden gelöscht.

HealthState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Diese Eigenschaft drückt die Integrität dieses Elements aus, aber nicht unbedingt die seiner Unterkomponenten. Die möglichen Werte sind 0 bis 30, wobei 5 bedeutet, dass das Element vollständig fehlerfrei ist und 30 bedeutet, dass das Element vollständig nicht funktionsfähig ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 5 (OK) festgelegt.

Wert	Bedeutung
5	Die Integrität status ist normal.

IdentifyingDescriptions

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Ein Array von Zeichenfolgen, das Erklärungen und Details hinter den Einträgen im Array OtherIdentifyingInfo bereitstellt. Jeder Eintrag dieses Arrays bezieht sich auf den Eintrag in OtherIdentifyingInfo , der sich am selben Index befindet. Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der Erstellung der Konfiguration des virtuellen Computers. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

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

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

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, Override, MaxLen ( 256 )

Der geerbte Name dient als Schlüssel eines Systems instance in einer Unternehmensumgebung. Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

NameFormat

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen ( 64 )

Gibt an, wie der Systemname mithilfe der Heuristik der Unterklasse generiert wurde. Das Systemobjekt und seine Ableitungen sind Objekte der obersten Ebene von CIM. Sie bieten den Umfang für zahlreiche Komponenten. Eindeutige Systemschlüssel sind erforderlich. Eine Heuristik kann in einzelnen Systemunterklassen definiert werden, um zu versuchen, immer denselben Systemnamenschlüssel zu generieren. Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

OnTimeInMilliseconds

Datentyp: uint64
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten ("MilliSekunden")

Die Gesamtzeit in Millisekunden, seit der virtuelle Computer zuletzt aktiviert, zurückgesetzt oder wiederhergestellt wurde. Dieses Mal schließt die Zeit aus, zu der sich der virtuelle Computer im angehaltenen Zustand befand.

OperatingStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt aktuelle status Informationen für den Betriebszustand des Elements bereit und kann verwendet werden, um weitere Details in Bezug auf den Wert der EnabledState-Eigenschaft bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

OperationalStatus

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Die aktuellen Status des -Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und jedes Arrayelement ist immer auf 2 (OK) festgelegt.

OtherDedicatedDescriptions

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die beschreibt, wie oder warum das System dediziert wird, wenn das Dedicated-Array den Wert 2 , "Sonstige", enthält. Diese Eigenschaft wird von der CIM_ComputerSystem-Klasse geerbt.

OtherEnabledState

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 ("Sonstige") festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState einen anderen Wert als 1 aufweist. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf Null festgelegt.

OtherIdentifyingInfo

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Enthält zusätzliche Daten, die über die Informationen zum Systemnamen hinausgehen, die zum Identifizieren eines ComputerSystems verwendet werden können. Ein Beispiel wäre die Verwendung des Fibre Channel World-Wide Name (WWN) eines Knotens. Wenn nur der Fibre Channel-Name verfügbar und eindeutig ist (kann als Systemschlüssel verwendet werden), dann wäre diese Eigenschaft Null , und der WWN würde zum Systemschlüssel, dessen Daten in der Name-Eigenschaft platziert werden. Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

PowerManagementCapabilities

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von der CIM_ComputerSystem-Klasse geerbt, wird aber nicht unterstützt.

PrimaryOwnerContact

Datentyp: string
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: MaxLen ( 256 )

Eine Zeichenfolge, die Informationen darüber bereitstellt, wie der primäre Systembesitzer erreicht werden kann (z. B. Telefonnummer, E-Mail-Adresse usw.). Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

PrimaryOwnerName

Datentyp: string
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: MaxLen ( 64 )

Der Name des primären Systembesitzers. Der Systembesitzer ist der primäre Benutzer des Systems. Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

PrimaryStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt allgemeine status Informationen bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um allgemeine und detaillierte Integrität status Informationen für das Element und seine Unterkomponenten bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ProcessID

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Der Bezeichner des Prozesses, unter dem dieser virtuelle Computer ausgeführt wird. Dieser Wert kann verwendet werden, um die instance von Vmwp.exe auf dem System, auf dem der virtuelle Computer ausgeführt wird, eindeutig zu identifizieren.

RequestedState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für das Element. Der tatsächliche Zustand des Elements wird durch EnabledState dargestellt. Diese Eigenschaft wird bereitgestellt, um den zuletzt angeforderten und den aktuellen Status für ein Element zu vergleichen. Eine bestimmte instance der CIM_EnabledLogicalElement-Klasse unterstützt die RequestedState-Eigenschaft möglicherweise nicht. In diesem Fall wird der Wert 12 ("Nicht zutreffend") verwendet. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf 12 (Nicht zutreffend) festgelegt.

Wert	Bedeutung
12	Nicht zutreffend

ResetCapability

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die Zurücksetzungsfunktionen des Computersystems an. Diese Eigenschaft wird von der CIM_ComputerSystem-Klasse geerbt.

Wert	Bedeutung
Andere 1
Unbekannt 2
Disabled 3	Das Zurücksetzen der Hardware ist nicht zulässig.
Aktiviert 4	Das Computersystem kann mithilfe von Hardware zurückgesetzt werden (z. B. die Ein-/Aus- und Zurücksetzungstasten).
Nicht implementiert 5

Rollen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Lese-/Schreibzugriff

Ein Array von Zeichenfolgen, das die vom Administrator definierten Rollen angibt, die dieses System in der verwalteten Umgebung spielt. Beispiele wären "Building 8 print server" oder "Boise user directories". Ein einzelnes System kann mehrere Rollen ausführen. Die Instrumentierungsansicht der Rollen eines Systems wird durch Instanziieren einer bestimmten Unterklasse des Systems oder durch Eigenschaften in einer Unterklasse oder beides definiert. Beispielsweise wird der Zweck eines ComputerSystem mithilfe der Eigenschaften Dedicated und OtherDedicatedDescription definiert. Diese Eigenschaft wird von der CIM_System-Klasse geerbt.

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, aber nicht verwendet.

StatusBeschreibungen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und jedes Arrayelement wird immer auf "Der Dienst wird normal ausgeführt" festgelegt.

TimeOfLastConfigurationChange

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der letzten Änderung der Konfigurationsdatei des virtuellen Computers. Die Konfigurationsdatei wird während bestimmter Vorgänge für virtuelle Computer sowie beim Hinzufügen, Ändern oder Entfernen von Einstellungen für virtuelle Computer oder Geräte geändert.

TimeOfLastStateChange

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der letzten Änderung des aktivierten Zustands des Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt, wird aber nicht unterstützt.

TransitioningToState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, in den die instance übergehen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert	Bedeutung
Unbekannt 0
Aktiviert 2
Disabled 3
Herunterfahren 4
Keine Änderung 5	Es wird kein Übergang ausgeführt.
Offline 6
Test 7
Verzögern 8
Stilllegen 9
Neustart 10
Zurücksetzen 11
Nicht verfügbar 12	Die Implementierung unterstützt die Darstellung laufender Übergänge nicht.
DMTF Reserviert ..

Anforderungen

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

Siehe auch

CIM_ComputerSystem
Msvm_VirtualSystemManagementService . ImportSystemDefinition-Methode