Msvm_VirtualHardDiskSettingData classe
Fournit des données de paramétrage pour un disque dur virtuel.
La syntaxe suivante est un code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.
Syntaxe
[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;
};
Membres
La classe Msvm_VirtualHardDiskSettingData a les types de membres suivants :
Propriétés
La classe Msvm_VirtualHardDiskSettingData a ces propriétés.
-
BlockSize
-
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Taille de bloc utilisée par le disque dur virtuel, en octets.
-
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Brève description de l’objet. Cette propriété est héritée de CIM_ManagedElement et est toujours définie sur « Données de définition de disque dur virtuel ».
-
-
DataAlignment
-
-
Type de données : uint64
-
Type d’accès : Lecture/écriture
Spécifie l’alignement souhaité, en octets, pour la charge utile de données du disque virtuel
Notes
Ajouté dans Windows 10, version 1709.
-
-
Description
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description de l'objet . Cette propriété est héritée de CIM_ManagedElement, et elle est toujours définie sur « Définition des données pour un disque dur virtuel ».
-
-
ElementName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom complet de l’objet. Cette propriété est héritée de CIM_ManagedElement.
-
-
Format
-
-
Type de données : uint16
-
Type d’accès : Lecture/écriture
Format du disque dur virtuel. Il s’agit de l’une des valeurs suivantes.
-
-
VHD (2)
-
VHDX (3)
-
VHDSet (4)
-
Notes
Ajout dans Windows 10 et Windows Server 2016.
InstanceID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Clé
Identifie de manière unique un instance de cette classe. Cette propriété est héritée de CIM_SettingData.
IsPmemCompatible
-
Type de données : booléen
-
Type d’accès : Lecture/écriture
Spécifie si le disque virtuel peut être utilisé comme magasin de stockage pour un périphérique de mémoire persistante.
Notes
Ajouté dans Windows 10, version 1709.
LogicalSectorSize
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Taille de secteur logique utilisée par le disque dur virtuel, en octets.
MaxInternalSize
-
Type de données : uint64
-
Type d’accès : Lecture/écriture
Taille maximale du disque dur virtuel visible par la machine virtuelle, en octets. Cette taille est arrondie au prochain plus grand multiple de la taille du secteur.
ParentIdentifier
-
Type de données : chaîne
-
Type d'accès : Lecture seule
GUID utilisé pour identifier de manière unique le parent du disque dur virtuel. Si le disque dur virtuel n’a pas de parent, ce champ est vide.
Notes
Ajout dans Windows 10 et Windows Server 2016.
ParentPath
-
Type de données : chaîne
-
Type d’accès : Lecture/écriture
Parent du disque dur virtuel. Si le disque dur virtuel n’a pas de parent, cette propriété est vide.
ParentTimestamp
-
Type de données : DATETIME
-
Type d'accès : Lecture seule
Horodatage du parent du disque dur virtuel. Si le disque dur virtuel n’a pas de parent, ce champ est vide.
Notes
Ajout dans Windows 10 et Windows Server 2016.
Chemin d’accès
-
Type de données : chaîne
-
Type d’accès : Lecture/écriture
Chemin complet du disque dur virtuel.
PhysicalSectorSize
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Taille de secteur physique utilisée par le disque dur virtuel, en octets.
PmemAddressAbstractionType
-
Type de données : uint16
-
Type d’accès : Lecture/écriture
Méthode d’abstraction d’adresse mémoire persistante à utiliser avec ce disque virtuel.
Notes
Ajouté dans Windows 10, version 1709.
Aucun (0)
BTT (1)
Inconnu (65535)
Type
-
Type de données : uint16
-
Type d’accès : Lecture/écriture
Type de disque dur virtuel. Il s’agit de l’une des valeurs suivantes.
Correction (2)
Dynamique (3)
Différenciation (4)
VirtualDiskId
-
Type de données : chaîne
-
Type d’accès : Lecture/écriture
GUID utilisé pour identifier de manière unique le disque virtuel.
Lorsque la méthode Msvm_ImageManagementService.GetVirtualHardDiskSettingData retourne une instance de Msvm_VirtualHardDiskSettingData, le client peut utiliser cette propriété pour obtenir l’ID de disque unique du disque dur virtuel.
En cas de détection de conflit ou autre, un client peut définir la valeur VirtualDiskId sur un nouveau GUID et passer cette Msvm_VirtualHardDiskSettingData instance à la méthode Msvm_ImageManagementService.SetVirtualHardDiskSettingData pour modifier l’ID de disque dur virtuel. Si le disque dur virtuel n’est pas un disque dur virtuel VHDX ou si le disque dur virtuel est attaché, l’opération échoue. L’opération échoue également si la valeur passée est incorrecte, c’est-à-dire pas un GUID ou a tous les 0. L’opération réussit en mode silencieux si la valeur passée est identique à l’ID de disque actuel.
Les erreurs générées par la fonction SetVirtualDiskInformation sont mises en bulles via cette propriété. Un client peut également utiliser le même mécanisme pour fournir la valeur VirtualDiskId lors de la création du disque dur virtuel via la méthode Msvm_ImageManagementService.CreateVirtualHardDisk dans le même espace de noms. Cela peut être utilisé pour créer des disques durs virtuels VHD1 ou VHD2.
Windows 8.1 : cette valeur n’est pas prise en charge tant que Windows 8.1 et Windows Server 2012 R2.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2012 [applications de bureau uniquement] |
| Espace de noms |
Racine\Virtualisation\V2 |
| MOF |
|
| DLL |
|