Msvm_ImageManagementService-Klasse
Verwaltet die virtuellen Medien (VHD-, VHDX-, ISO- oder VFD-Dateien) für einen virtuellen Computer.
Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.
Syntax
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ImageManagementService : CIM_Service
{
string InstanceID;
string Caption = "Hyper-V Image Management Service";
string Description = "Provides Image Management servicing for Hyper-V";
string ElementName = "Hyper-V Image Management Service";
datetime InstallDate;
uint16 OperationalStatus[] = { 2 };
string StatusDescriptions[] = { "OK" };
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_ImageManagementService";
string Name = "vhdsvc";
string PrimaryOwnerName;
string PrimaryOwnerContact;
string StartMode;
boolean Started = True;
};
Member
Die Msvm_ImageManagementService-Klasse verfügt über folgende Membertypen:
Methoden
Die Msvm_ImageManagementService-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| AttachVirtualHardDisk | Fügt eine Imagedatei des virtuellen Datenträgers im Loopbackmodus an. |
| CompactVirtualHardDisk | Komprimiert eine virtuelle Festplattendatei. |
| ConvertVirtualHardDisk | Konvertiert eine vorhandene virtuelle Festplatte in einen anderen Typ oder ein anderes Format. |
| ConvertVirtualHardDiskToVHDSet | Konvertiert eine virtuelle Festplattendatei, indem neben der vorhandenen virtuellen Festplatte eine neue VHD-Set-Datei erstellt wird. |
| CreateVirtualFloppyDisk | Erstellt eine Datei mit einem virtuellen Diskettendatenträger. |
| CreateVirtualHardDisk | Erstellt eine virtuelle Festplattendatei. |
| DeleteVHDSnapshot | Löscht einen VHD-Momentaufnahmeeintrag in einer VHD-Set-Datei. |
| FindMountedStorageImageInstance | Sucht nach einem Msvm_MountedStorageImage -Objekt für einen angegebenen Datenträgerimagepfad. |
| GetVHDSetInformation | Ruft Informationen zu einer VHD-Set-Datei ab. |
| GetVHDSnapshotInformation | Ruft Informationen zu einer VHD-Momentaufnahme in einer VHD-Set-Datei ab. |
| GetVirtualDiskChanges | Ruft eine Liste der Änderungen in der angegebenen Region eines virtuellen Datenträgers ab, da die angegebene resiliente Änderungsnachverfolgung-ID oder VHDSet-Momentaufnahme-ID angegeben wurde. |
| GetVirtualHardDiskSettingData | Ruft Einstellungsdaten ab, die virtuellen Festplattendateien zugeordnet sind. |
| GetVirtualHardDiskState | Ruft den Status virtueller Festplattendateien ab. |
| MergeVirtualHardDisk | Führt eine untergeordnete virtuelle Festplatte in einer Differenzierungskette mit einer oder mehreren übergeordneten virtuellen Festplatten in der Kette zusammen. |
| OptimizeVHDSet | Optimiert eine VHD-Set-Datei, um weniger Speicherplatz zu verwenden. |
| RequestStateChange | Fordert eine Zustandsänderung an. |
| ResizeVirtualHardDisk | Ändert die Größe einer vorhandenen virtuellen Festplatte. |
| SetParentVirtualHardDisk | Updates das übergeordnete Element für die angegebenen blatt- und untergeordneten virtuellen Festplattendateien. |
| SetVHDSnapshotInformation | Bearbeitet einen VHD-Momentaufnahmeeintrag in einer VHD-Set-Datei. Wenn die fragliche Momentaufnahme-ID bereits vorhanden ist, wird der vorhandene Momentaufnahmeeintrag mit dem neuen Eintrag überschrieben. Andernfalls wird der neue Eintrag der VHD-Set-Datei hinzugefügt. |
| SetVirtualHardDiskSettingData | Legt eine virtuelle Festplattendatei fest. |
| Startservice | Startet den Dienst. |
| StopService | Beendet den Dienst. |
| ValidatePersistentReservationSupport | Überprüft, ob ein Dateisystem eine virtuelle Festplatte mit aktivierten persistenten Reservierungen unterstützen kann. |
| ValidateVirtualHardDisk | Überprüft, ob ein Image eines virtuellen Datenträgers im schreibgeschützten Modus geöffnet werden kann. |
Eigenschaften
Die Msvm_ImageManagementService-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 immer auf Null festgelegt.
-
-
Caption
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Hyper-V Image 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 Reserviert (..)
-
Vendor Reserved (0x8000.. )
-
-
CreationClassName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name der Klasse oder Unterklasse, die bei der Erstellung eines instance verwendet wird. Diese Eigenschaft wird von CIM_Service geerbt und immer auf "Msvm_ImageManagementService" festgelegt.
-
-
Beschreibung
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Stellt die Imageverwaltung für Hyper-V bereit".
-
-
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 Image 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.
-
-
EnabledState
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
Die aktivierten und deaktivierten Zustände eines Elements. Es 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.
-
-
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 festgelegt.
-
-
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 eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_ManagedElement geerbt.
-
-
Name
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel, Überschreibung ("Name"), MaxLen (256)
Die Bezeichnung, unter der das Objekt bekannt ist. Diese Eigenschaft wird von CIM_Service geerbt und ist immer auf "vhdsvc" 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)
-
Im Test (14)
-
Übergang (15)
-
Im Dienst (16)
-
DMTF Reserviert (..)
-
Vendor Reserved (0x8000.. )
-
-
OperationalStatus
-
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
Die aktuelle 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
Der aktivierte oder deaktivierte Zustand des Elements, 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 geerbt und ist immer auf NULL festgelegt.
-
-
PrimaryOwnerContact
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine Zeichenfolge, die Informationen darüber bereitstellt, 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 ist immer auf NULL festgelegt.
-
-
PrimaryOwnerName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des primären Besitzers für den Dienst, sofern einer definiert ist. Der primäre Besitzer ist der erste Supportkontakt für den Dienst. Diese Eigenschaft wird von CIM_Service geerbt und ist 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 aktivierten oder deaktivierten Status zu vergleichen. Eine bestimmte instance von EnabledLogicalElement unterstützt RequestedStateChange 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.
-
-
Started
-
-
Datentyp: boolean
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob der Dienst gestartet wurde. Diese Eigenschaft wird von CIM_Service geerbt und ist immer auf True festgelegt.
-
-
StartMode
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
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.
-
-
SystemCreationClassName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
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
Der 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_ImageManagementService-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 |
|