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, Momentaufnahmen und Importieren oder Exportieren von virtuellen Computern. Um Informationen pro virtuellem Computer abzurufen, verwenden Sie Msvm _ ComputerSystem.

Die folgende Syntax wird Managed Object Format (MOF)-Code vereinfacht 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 Konfiguration des virtuellen Systems Startquellen hinzu, wenn sie auf eine Konfiguration des virtuellen Zustandssystems angewendet wird.
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 in einem virtuellen Computer hinzu.
AddGuestServiceSettings Fügt einer Konfiguration des virtuellen Systems Gastdiensteinstellungen hinzu.
Wenn sie auf Teile einer "aktuellen" Konfiguration des virtuellen Systems angewendet wird, 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 einer Konfiguration eines virtuellen Computers Ressourcen hinzu.
AddSystemComponentSettings Fügt einer Konfiguration des virtuellen Systems 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 Definition für virtuelle Computer.
DestroySystem Löscht eine vorhandene Definition eines virtuellen Computers.
DiagnoseNetworkConnection Diagnostizieren der Netzwerkkonnektivität eines virtuellen Computers in Windows Netzwerkvirtualisierungsumgebung
ExportSystemDefinition Exportiert einen virtuellen Computer oder eine 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 einen Satz von WWPNs (World Wide Port Names).
GetCurrentWwpnFromGenerator Bietet die Möglichkeit, eine Vorschau des aktuellen WWPN (World Wide Port Name) anzuzeigen, ohne dass die WWPN reserviert ist.
GetDefinitionFileSummaryInformation Gibt Zusammenfassungsinformationen des virtuellen Computers für die angegebenen Definitionsdateien des virtuellen Computers zurück.
GetSizeOfSystemFiles Ruft die Gesamtgröße der Systemdateien des virtuellen Computers ab.
GetSummaryInformation Gibt Zusammenfassungsinformationen zu virtuellen Computern zurück.
GetVirtualSystemThumbnailImage Ruft ein Miniaturbild eines vorhandenen virtuellen Computers ab.
ImportSnapshotDefinitions Durchsucht den angegebenen Ordner nach Momentaufnahmedefinitionsdateien, 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 Definition des virtuellen Computers.
ModifyDiskMergeSettings Ändert die Daten der Datenträgerzusammenführungseinstellung.
ModifyFeatureSettings Ändert die aktuellen Featureeinstellungen einer Ethernet-Verbindung eines virtuellen Computers.
ModifyGuestServiceSettings Ändert Gastdiensteinstellungen.
Wenn sie auf Teile einer "aktuellen" Konfiguration des virtuellen Systems angewendet wird, 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 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 Konfiguration des virtuellen Systems.
Wenn sie auf Teile einer "aktuellen" Konfiguration des virtuellen Systems angewendet wird, 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 in einem virtuellen Computer.
RemoveGuestServiceSettings Entfernt Gastdiensteinstellungen aus einer Konfiguration des virtuellen Systems.
Wenn sie auf Teile einer "aktuellen" Konfiguration des virtuellen Systems angewendet wird, 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 Einstellungen für virtuelle Ressourcen aus der Konfiguration eines virtuellen Computers.
RemoveSystemComponentSettings Entfernt allgemeine Komponenteneinstellungen aus einer Konfiguration des virtuellen Systems.
RequestStateChange Diese Methode wird nicht unterstützt.
SetGuestNetworkAdapterConfiguration Konfiguriert die Netzwerkadapter im Gastbetriebssystem.
SetInitialMachineConfigurationData Legt die anfänglichen Computerkonfigurationsdaten eines virtuellen Computers fest.
Startservice Diese Methode wird nicht unterstützt.
StopService Diese Methode wird nicht unterstützt.
TestNetworkConnection Testet die Netzwerkkonnektivität eines virtuellen Computers in Windows Netzwerkvirtualisierungsumgebung.
UpgradeSystemVersion Aktualisiert das virtuelle System.
Bei Anwendung auf die Systemeinstellungen einer "aktuellen" Konfiguration des virtuellen Systems
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 geerbtund immer auf NULL festgelegt.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM _ ManagedElement geerbtund 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)

Verlorene Kommunikation (3)

Kein Kontakt (4)

DMTF Reserved (..)

Reservierter Anbieter (0x8000. )

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen ( 256 )

Der Name der Klasse oder Unterklasse, die bei der Erstellung einer Instanz verwendet wird. Diese Eigenschaft wird vom _ CIM-Dienst geerbtund immer auf "Msvm _ VirtualSystemManagementService" festgelegt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM _ ManagedElement geerbtund immer auf "Dienst zum Erstellen, Bearbeiten und Verwalten virtueller Computer" festgelegt.

DetailedStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft um zusätzliche Statusdetails. 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)

Verstrichen (2)

Vorhersagefehler (3)

Nicht wiederherstellbarer Fehler (4)

Unterstützende Entität im Fehler (5)

DMTF Reserved (..)

Reservierter Anbieter (0x8000. )

ElementName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM _ ManagedElement geerbtund 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 Zustand eines Elements. Diese Eigenschaft wird von CIM _ EnabledLogicalElement geerbtund immer auf 2 (Aktiviert) festgelegt.

Wert Bedeutung
2
Aktiviert

EnabledState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der aktivierte und deaktivierte Zustände eines Elements. Diese Eigenschaft kann auch die Übergänge zwischen diesen angeforderten Zuzuständen angeben. Diese Eigenschaft wird von CIM _ EnabledLogicalElement geerbtund 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 notwendigerweise 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 nichtfunktional ist. Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbtund immer auf 5 (OK) festgelegt.

Wert Bedeutung
5
Der Integritätsstatus 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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert eine Instanz dieser Klasse eindeutig. Diese Eigenschaft wird von CIM _ ManagedElement geerbt.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen ( 256 )

Die Bezeichnung, unter der das -Objekt bekannt ist. Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbtund immer auf "vmms" festgelegt.

OperatingStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt aktuelle Statusinformationen für die Betriebsbedingung des Elements zur Verfügung und kann verwendet werden, um weitere Details in Bezug auf den Wert der EnabledState-Eigenschaft zu erhalten. 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)

Wird beendet (4)

Beendet (5)

Abgebrochen (6)

Ruhend (7)

Abgeschlossen (8)

Migrieren (9)

Sollgrating (10)

Immigrating (11)

Momentaufnahmen (12)

Herunterfahren (13)

Im Test (14)

Übergang (15)

In Service (16)

DMTF Reserved (..)

Reservierter Anbieter (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: Zeichenfolge

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 ein anderer Wert als 1 ist. Diese Eigenschaft wird von CIM _ EnabledLogicalElement geerbtund immer auf NULL festgelegt.

PrimaryOwnerContact

Datentyp: Zeichenfolge

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 und so weiter). Diese Eigenschaft wird vom _ CIM-Dienst geerbtund immer auf NULL festgelegt.

PrimaryOwnerName

Datentyp: Zeichenfolge

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 vom _ CIM-Dienst geerbtund immer auf NULL festgelegt.

PrimaryStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt Statusinformationen auf hoher Ebene zur Verfügung. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um einen hohen und detaillierten Integritätsstatus des Elements und seiner Unterkomponenten zu bieten. Ein NULL-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

Unbekannt (0)

OK (1)

Heruntergestuft (2)

Fehler (3)

DMTF Reserved (..)

Reservierter Anbieter (0x8000. )

RequestedState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der zuletzt 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 Instanz der _ CIM-Klasse EnabledLogicalElement unterstützt möglicherweise die RequestedState-Eigenschaft 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

Begann

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Dienst derzeit ausgeführt wird. Diese Eigenschaft wird vom _ CIM-Dienst geerbtund immer auf True festgelegt.

StartMode

Datentyp: Zeichenfolge

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 vom _ CIM-Dienstgeerbt und immer auf NULL festgelegt.

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt, aber nicht verwendet.

StatusDescriptions

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

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

SystemCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel, MaxLen ( 256 )

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird vom _ CIM-Dienstgeerbt und immer auf "Msvm _ ComputerSystem" festgelegt.

Systemname

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel, MaxLen ( 256 )

Der NetBIOS-Name des Hostcomputersystems. Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

TimeOfLastStateChange

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das Datum oder die Uhrzeit der letzten Änderung des aktivierten Zustands des Elements. Diese Eigenschaft wird von CIM _ EnabledLogicalElementgeerbt.

TransitioningToState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, in den die Instanz übergehen soll. Diese Eigenschaft wird von CIM _ EnabledLogicalElementgeerbt und immer auf NULL festgelegt.

Hinweise

Der Zugriff auf die Msvm _ VirtualSystemManagementService-Klasse kann durch die 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