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
WindowsVirtualization. v2. mof
DLL
Vmms.exe

Voir aussi

_SETTINGDATA CIM

GetVirtualHardDiskSettingData