Freigeben über


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
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Weitere Informationen

CIM_VirtualSystemManagementService

CIM_VirtualSystemManagementService

Msvm_VirtualSystemManagementService (V1)

Verwaltungsklassen für virtuelle Systeme