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