MSVM _ VirtualHardDiskSettingData, classe
Fournit des données de définition pour un disque dur virtuel.
La syntaxe suivante est simplifiée format MOF (MOF) et comprend 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 possède les types de membres suivants :
Propriétés
La classe MSVM _ VirtualHardDiskSettingData possède les propriétés suivantes.
-
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 _ propriété ManagedElementet est toujours définie sur « données de paramètre 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 _ propriété ManagedElementet 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 la _ propriété ManagedElement CIM.
-
-
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.
-
-
Disque dur virtuel (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 façon unique une instance de cette classe. Cette propriété est héritée de la _ SettingData CIM.
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, en octets, du disque dur virtuel, tel qu’il est visible par l’ordinateur virtuel. Cette taille sera arrondie au plus grand multiple de la taille de secteur suivante.
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
Horodateur 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
Le chemin d’accès 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.
Résolu (2)
Dynamique (3)
Différenciation (4)
VirtualDiskId
-
Type de données : chaîne
-
Type d’accès : lecture/écriture
GUID utilisé pour identifier le disque virtuel de façon unique.
Lorsque la méthode MSVM _ ImageManagementService. GetVirtualHardDiskSettingData retourne une instance de MSVM _ VirtualHardDiskSettingData, le client peut utiliser cette propriété pour récupérer l’ID de disque unique du disque dur virtuel.
Lors de la détection de conflit ou dans le cas contraire, un client peut définir la valeur VirtualDiskId sur un nouveau GUID et passer cette instance MSVM _ VirtualHardDiskSettingData à la méthode MSVM _ ImageManagementService. SetVirtualHardDiskSettingData pour modifier l’ID de disque du 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 transmise est incorrecte, autrement dit, qu’il ne s’agit pas d’un GUID ou qu’il ne contient que des 0. L’opération réussit silencieusement si la valeur passée est identique à l’ID de disque actuel.
Les erreurs générées par la fonction SetVirtualDiskInformation sont propagées par le biais de cette propriété. Un client peut également utiliser le même mécanisme pour fournir la valeur VirtualDiskId lors de la création d’un 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.
Configuration requise
| 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 |
\Virtualisation racine \ v2 |
| MOF |
|
| DLL |
|