Msvm_VirtualSystemManagementService-Klasse
Stellt den Virtualisierungsdienst dar, der auf einem einzelnen Hostsystem vorhanden ist. Msvm_VirtualSystemManagementService wird verwendet, um die Definition, Änderung und Löschung von virtuellen Computern zu steuern. Es verfügt auch über Methoden zum Ausführen von Vorgängen auf virtuellen Computern, z. B. Klonen, Momentaufnahme und importieren oder exportieren von virtuellen Computern. Verwenden Sie Msvm_ComputerSystem, um Vm-Informationen abzurufen.
Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.
Syntax
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
string InstanceID;
string Caption = "Virtual System Management Service";
string Description = "Service for creating, manipulating, and managing virtual machines";
string ElementName = "Hyper-V Virtual System Management Service";
datetime InstallDate;
string Name = "vmms";
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 = 2;
string OtherEnabledState;
uint16 RequestedState = 12;
uint16 EnabledDefault = 2;
datetime TimeOfLastStateChange;
uint16 AvailableRequestedStates[];
uint16 TransitioningToState;
string SystemCreationClassName = "Msvm_ComputerSystem";
string SystemName;
string CreationClassName = "Msvm_VirtualSystemManagementService";
string PrimaryOwnerName;
string PrimaryOwnerContact;
string StartMode;
boolean Started = True;
};
Member
Die Msvm_VirtualSystemManagementService-Klasse verfügt über die folgenden Membertypen:
Methoden
Die Msvm_VirtualSystemManagementService-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| AddBootSourceSettings | Fügt einer virtuellen Systemkonfiguration Startquellen hinzu, wenn sie auf eine Konfiguration des virtuellen "Zustands" angewendet werden. |
| AddFeatureSettings | Fügt der Konfiguration einer Ethernet-Verbindung eines virtuellen Computers Ethernet-Featureeinstellungen hinzu. |
| AddFibreChannelChap | Fügt DH-CHAP-Parameter zu einem synthetischen Fibre Channel-Port auf einem virtuellen Computer hinzu. |
| AddGuestServiceSettings | Fügt Gastdiensteinstellungen zu einer virtuellen Systemkonfiguration hinzu. Wenn sie auf Teile einer "aktuellen" virtuellen Systemkonfiguration angewendet werden, können Gastdienste des aktiven virtuellen Systems als Nebeneffekt geändert werden. |
| AddKvpItems | Fügt einem virtuellen Computer Schlüssel-Wert-Paare hinzu. |
| AddResourceSettings | Fügt Ressourcen zu einer VM-Konfiguration hinzu. |
| AddSystemComponentSettings | Fügt einer virtuellen Systemkonfiguration generische Einstellungen hinzu. |
| DefinePlannedSystem | Definiert ein geplantes virtuelles System. Eingaben, die nicht vollständig angegeben sind, können mit Standardwerten ausgefüllt werden. |
| DefineSystem | Erstellt eine neue VM-Definition. |
| DestroySystem | Löscht eine vorhandene VM-Definition. |
| DiagnoseNetworkConnection | Diagnose der Netzwerkkonnektivität eines virtuellen Computers in einer Windows-Netzwerkvirtualisierungsumgebung. |
| ExportSystemDefinition | Exportiert einen virtuellen Computer oder einen Momentaufnahme eines virtuellen Computers in eine Datei. |
| FormatError | Gibt eine formatierte Fehlermeldungszeichenfolge für das angegebene Array eingebetteter Msvm_Error-Instanzen zurück. |
| GenerateWwpn | Generiert eine Reihe von World Wide Port Names (WWPNs). |
| GetCurrentWwpnFromGenerator | Bietet die Möglichkeit, eine Vorschau des aktuellen World Wide Port Name (WWPN) anzuzeigen, ohne dass der WWPN reserviert ist. |
| GetDefinitionFileSummaryInformation | Gibt Zusammenfassungsinformationen für virtuelle Computer für die angegebenen VM-Definitionsdateien zurück. |
| GetSizeOfSystemFiles | Ruft die Gesamtgröße der Systemdateien des virtuellen Computers ab. |
| GetSummaryInformation | Gibt Zusammenfassungsinformationen für den virtuellen Computer zurück. |
| GetVirtualSystemThumbnailImage | Ruft eine Miniaturansicht eines vorhandenen virtuellen Computers ab. |
| ImportSnapshotDefinitions | Durchsucht den angegebenen Ordner nach Momentaufnahme Definitionsdateien, die dem angegebenen geplanten Computersystem zugeordnet sind, und erstellt eine neue Momentaufnahme auf dem geplanten Computersystem für jede zugeordnete Definitionsdatei an diesem Speicherort. |
| ImportSystemDefinition | Erstellt ein neues geplantes Computersystem basierend auf der angegebenen VM-Definition. |
| ModifyDiskMergeSettings | Ändert die Daten der Datenträgerzusammenführungseinstellung. |
| ModifyFeatureSettings | Ändert die aktuellen Featureeinstellungen einer Ethernet-Verbindung eines virtuellen Computers. |
| ModifyGuestServiceSettings | Ändert die Gastdiensteinstellungen. Wenn sie auf Teile einer "aktuellen" virtuellen Systemkonfiguration angewendet werden, können Gastdienste des aktiven virtuellen Systems als Nebeneffekt geändert werden. |
| ModifyKvpItems | Ändert vorhandene Schlüssel-Wert-Paare auf einem virtuellen Computer. |
| ModifyResourceSettings | Ändert die Einstellungen für virtuelle Ressourcen. |
| ModifyServiceSettings | Ändert die Einstellungsdaten des Diensts. |
| ModifySystemComponentSettings | Ändert generische Systemkomponenteneinstellungen. |
| ModifySystemSettings | Ändert die Einstellungen des virtuellen Computers. |
| RealizePlannedSystem | Überprüft die Konfiguration eines geplanten virtuellen Computers und konvertiert ihn in einen realisierten virtuellen Computer. |
| RemoveBootSourceSettings | Entfernt Einstellungen für virtuelle Ressourcen aus einer virtuellen Systemkonfiguration. Wenn sie auf Teile einer "aktuellen" virtuellen Systemkonfiguration angewendet werden, können als Nebeneffekt Ressourcen des aktiven virtuellen Systems entfernt werden. |
| RemoveFeatureSettings | Entfernt Featureeinstellungen aus einer Ethernet-Verbindung eines virtuellen Computers. |
| RemoveFibreChannelChap | Entfernt DH-CHAP-Parameter aus einem synthetischen Fibre Channel-Port auf einem virtuellen Computer. |
| RemoveGuestServiceSettings | Entfernt Gastdiensteinstellungen aus einer virtuellen Systemkonfiguration. Wenn sie auf Teile einer "aktuellen" virtuellen Systemkonfiguration angewendet werden, können Gastdienste des aktiven virtuellen Systems als Nebeneffekt geändert werden. |
| RemoveKvpItems | Entfernt vorhandene Schlüssel-Wert-Paare von einem virtuellen Computer. |
| RemoveResourceSettings | Entfernt die Einstellungen virtueller Ressourcen aus einer VM-Konfiguration. |
| RemoveSystemComponentSettings | Entfernt generische Komponenteneinstellungen aus einer virtuellen Systemkonfiguration. |
| RequestStateChange | Diese Methode wird nicht unterstützt. |
| SetGuestNetworkAdapterConfiguration | Konfiguriert die Netzwerkadapter innerhalb des Gastbetriebssystems. |
| SetInitialMachineConfigurationData | Legt die anfänglichen Computerkonfigurationsdaten einer VM fest. |
| Startservice | Diese Methode wird nicht unterstützt. |
| StopService | Diese Methode wird nicht unterstützt. |
| TestNetworkConnection | Testet die Netzwerkkonnektivität eines virtuellen Computers in einer Windows-Netzwerkvirtualisierungsumgebung. |
| UpgradeSystemVersion | Aktualisiert das virtuelle System. Bei Anwendung auf die Systemeinstellungen einer "aktuellen" virtuellen Systemkonfiguration |
| ValidatePlannedSystem | Überprüft das angegebene geplante System. |
Eigenschaften
Die Msvm_VirtualSystemManagementService-Klasse verfügt über diese Eigenschaften.
-
AvailableRequestedStates
-
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
Gibt die möglichen Werte für den RequestedState-Parameter der RequestStateChange-Methode an. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf NULL festgelegt.
-
-
Caption
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Hyper-V Virtual System Management Service" 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.
-
Unbekannt (0)
-
Nicht verfügbar (1)
-
Kommunikation OK (2)
-
Kommunikation verloren (3)
-
Kein Kontakt (4)
-
DMTF Reserviert (..)
-
Vendor Reserved (0x8000.. )
-
-
CreationClassName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel, MaxLen ( 256 )
Der Name der Klasse oder Unterklasse, die bei der Erstellung eines instance verwendet wird. Diese Eigenschaft wird von CIM_Service geerbt und ist immer auf "Msvm_VirtualSystemManagementService" festgelegt.
-
-
Beschreibung
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Dienst zum Erstellen, Bearbeiten und Verwalten virtueller Computer" 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.
-
Nicht verfügbar (0)
-
Keine zusätzlichen Informationen (1)
-
Gestresst (2)
-
Vorhersagefehler (3)
-
Nicht wiederherstellbarer Fehler (4)
-
Unterstützen von Entitäten im Fehler (5)
-
DMTF Reserviert (..)
-
Vendor Reserved (0x8000.. )
-
-
ElementName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Hyper-V Virtual System Management Service" festgelegt.
-
-
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 ist immer auf 2 (Aktiviert) festgelegt.
Wert Bedeutung - 2
Aktiviert -
-
EnabledState
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die aktivierten und deaktivierten Zustände eines Elements. Diese Eigenschaft kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf 2 (Aktiviert) festgelegt.
Wert Bedeutung - 2
Aktiviert -
-
HealthState
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die aktuelle Integrität des Elements. Dieses Attribut drückt die Integrität dieses Elements aus, aber nicht unbedingt die integrität 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äts status ist normal. -
-
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, MaxLen ( 256 )
Die Bezeichnung, unter der das Objekt bekannt ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf "vmms" festgelegt.
-
-
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.
-
Unbekannt (0)
-
Nicht verfügbar (1)
-
Wartung (2)
-
Ab (3)
-
Beenden (4)
-
Beendet (5)
-
Abgebrochen (6)
-
Ruhend (7)
-
Abgeschlossen (8)
-
Migrieren (9)
-
Auswandern (10)
-
Immigrieren (11)
-
Momentaufnahme (12)
-
Herunterfahren (13)
-
In Test (14)
-
Übergang (15)
-
Im Dienst (16)
-
DMTF Reserviert (..)
-
Vendor Reserved (0x8000.. )
-
-
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.
-
-
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.
-
-
PrimaryOwnerContact
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen ( 256 )
Alle Informationen darüber, wie der primäre Besitzer des Diensts erreicht werden kann (z. B. Telefonnummer, E-Mail-Adresse usw.). Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.
-
-
PrimaryOwnerName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen ( 64 )
Der Name des primären Besitzers für den Dienst, sofern definiert. Der primäre Besitzer ist der erste Supportkontakt für den Dienst. Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.
-
-
PrimaryStatus
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Stellt allgemeine status Informationen bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um eine allgemeine und detaillierte Integrität status des Elements und seiner Unterkomponenten bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
-
Unbekannt (0)
-
OK (1)
-
Herabgestuft (2)
-
Fehler (3)
-
DMTF Reserviert (..)
-
Vendor Reserved (0x8000.. )
-
-
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 -
-
Started
-
-
Datentyp: boolean
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob der Dienst derzeit ausgeführt wird. Diese Eigenschaft wird von CIM_Service geerbt und ist immer auf True festgelegt.
-
-
StartMode
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen ( 10 )
Ein Zeichenfolgenwert, der angibt, ob der Dienst automatisch von einem System, einem Betriebssystem oder nur auf Anforderung gestartet wird. Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.
-
-
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.
-
-
SystemCreationClassName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Key, MaxLen ( 256 )
Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_Service geerbt und immer auf "Msvm_ComputerSystem" festgelegt.
-
-
Systemname
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Key, MaxLen ( 256 )
Der NetBIOS-Name des Hostcomputersystems. Diese Eigenschaft wird von CIM_Service geerbt.
-
-
TimeOfLastStateChange
-
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
Das Datum oder die Uhrzeit der letzten Änderung des aktivierten Zustands des Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.
-
-
TransitioningToState
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Gibt den Zielzustand an, in den die instance übergehen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf Null festgelegt.
-
Bemerkungen
Der Zugriff auf die Msvm_VirtualSystemManagementService-Klasse kann durch UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.
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 |
|
| DLL |
|