Msvm_VirtualHardDiskSettingData-Klasse
Stellt Einstellungsdaten für eine virtuelle Festplatte bereit.
Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.
Syntax
[AMENDMENT]
class Msvm_VirtualHardDiskSettingData : CIM_SettingData
{
string InstanceID;
string Caption = "Virtual Hard Disk Setting Data";
string Description = "Setting Data for a Virtual Hard Disk";
string ElementName;
uint16 Type;
uint16 Format;
string Path;
string ParentPath;
DATETIME ParentTimestamp;
string ParentIdentifier;
uint64 MaxInternalSize;
uint32 BlockSize;
uint32 LogicalSectorSize;
uint32 PhysicalSectorSize;
string VirtualDiskId;
uint64 DataAlignment;
uint16 PmemAddressAbstractionType;
boolean IsPmemCompatible;
};
Member
Die Msvm_VirtualHardDiskSettingData-Klasse verfügt über die folgenden Membertypen:
Eigenschaften
Die Msvm_VirtualHardDiskSettingData-Klasse verfügt über diese Eigenschaften.
-
BlockSize
-
-
Datentyp: uint32
-
Zugriffstyp: Lese-/Schreibzugriff
Die von der virtuellen Festplatte verwendete Blockgröße in Bytes.
-
-
Caption
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Virtual Hard Disk Setting Data" festgelegt.
-
-
DataAlignment
-
-
Datentyp: uint64
-
Zugriffstyp: Lese-/Schreibzugriff
Gibt die gewünschte Ausrichtung in Bytes für die Datennutzlast des virtuellen Datenträgers an.
Hinweis
In Windows 10 Version 1709 hinzugefügt.
-
-
Beschreibung
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Festlegen von Daten für eine virtuelle Festplatte" festgelegt.
-
-
ElementName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM_ManagedElement geerbt.
-
-
Format
-
-
Datentyp: uint16
-
Zugriffstyp: Lese-/Schreibzugriff
Das Format für die virtuelle Festplatte. Dies ist einer der folgenden Werte.
-
-
VHD (2)
-
VHDX (3)
-
VHDSet (4)
-
Hinweis
In Windows 10 und Windows Server 2016 hinzugefügt.
InstanceID
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Identifiziert eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_SettingData geerbt.
IsPmemCompatible
-
Datentyp: Boolesch
-
Zugriffstyp: Lese-/Schreibzugriff
Gibt an, ob der virtuelle Datenträger als Sicherungsspeicher für ein Gerät mit persistentem Arbeitsspeicher verwendet werden kann.
Hinweis
In Windows 10 Version 1709 hinzugefügt.
LogicalSectorSize
-
Datentyp: uint32
-
Zugriffstyp: Lese-/Schreibzugriff
Die von der virtuellen Festplatte verwendete logische Sektorgröße in Bytes.
MaxInternalSize
-
Datentyp: uint64
-
Zugriffstyp: Lese-/Schreibzugriff
Die maximale Größe der virtuellen Festplatte, die vom virtuellen Computer in Bytes angezeigt werden kann. Diese Größe wird auf das nächstgrößeste Vielfache der Sektorgröße aufgerundet.
ParentIdentifier
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Die GUID, die verwendet wird, um das übergeordnete Element der virtuellen Festplatte eindeutig zu identifizieren. Wenn die virtuelle Festplatte kein übergeordnetes Element aufweist, ist dieses Feld leer.
Hinweis
In Windows 10 und Windows Server 2016 hinzugefügt.
ParentPath
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Lese-/Schreibzugriff
Das übergeordnete Element der virtuellen Festplatte. Wenn die virtuelle Festplatte kein übergeordnetes Laufwerk aufweist, ist diese Eigenschaft leer.
ParentTimestamp
-
Datentyp: DATETIME
-
Zugriffstyp: Schreibgeschützt
Der Zeitstempel des übergeordneten Datenträgers der virtuellen Festplatte. Wenn die virtuelle Festplatte kein übergeordnetes Element aufweist, ist dieses Feld leer.
Hinweis
In Windows 10 und Windows Server 2016 hinzugefügt.
Pfad
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Lese-/Schreibzugriff
Der vollqualifizierte Pfad der virtuellen Festplatte.
PhysicalSectorSize
-
Datentyp: uint32
-
Zugriffstyp: Lese-/Schreibzugriff
Die von der virtuellen Festplatte verwendete physische Sektorgröße in Bytes.
PmemAddressAbstractionType
-
Datentyp: uint16
-
Zugriffstyp: Lese-/Schreibzugriff
Die Methode zur Abstraktion persistenter Speicheradressen, die mit diesem virtuellen Datenträger verwendet werden soll.
Hinweis
In Windows 10 Version 1709 hinzugefügt.
Keine (0)
BTT (1)
Unbekannt (65535)
Typ
-
Datentyp: uint16
-
Zugriffstyp: Lese-/Schreibzugriff
Der Typ der virtuellen Festplatte. Dies ist einer der folgenden Werte.
Behoben (2)
Dynamisch (3)
Differenzierung (4)
VirtualDiskId
-
Datentyp: string
-
Zugriffstyp: Lese-/Schreibzugriff
Die GUID, die verwendet wird, um den virtuellen Datenträger eindeutig zu identifizieren.
Wenn die Msvm_ImageManagementService.GetVirtualHardDiskSettingData-Methode einen instance von Msvm_VirtualHardDiskSettingData zurückgibt, kann der Client diese Eigenschaft verwenden, um die eindeutige Datenträger-ID der VHD abzurufen.
Bei der Konflikterkennung oder auf andere Weise kann ein Client den VirtualDiskId-Wert auf eine neue GUID festlegen und diesen Msvm_VirtualHardDiskSettingData instance an die Msvm_ImageManagementService.SetVirtualHardDiskSettingData-Methode übergeben, um die Datenträger-ID der VHD zu ändern. Wenn die VHD keine VHDX-VHD ist oder die VHD angefügt ist, schlägt der Vorgang fehl. Der Vorgang schlägt auch fehl, wenn der übergebene Wert falsch formatiert ist, d. h. keine GUID oder alle 0s aufweist. Der Vorgang wird automatisch erfolgreich ausgeführt, wenn der übergebene Wert mit der aktuellen Datenträger-ID identisch ist.
Fehler, die von der SetVirtualDiskInformation-Funktion generiert werden, werden über diese Eigenschaft ausgegeben. Ein Client kann auch denselben Mechanismus verwenden, um den VirtualDiskId-Wert bei der VHD-Erstellung über die Msvm_ImageManagementService.CreateVirtualHardDisk-Methode im gleichen Namespace bereitzustellen. Dies kann verwendet werden, um VHD1- oder VHD2-VHDs zu erstellen.
Windows 8.1: Dieser Wert wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2.
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 |
|