Méthode CreateVirtualDisk de la classe MSFT_StorageSubSystem

Crée un disque virtuel.

Syntaxe

UInt32 CreateVirtualDisk(
  [in]      String              FriendlyName,
  [in]      UInt16              Usage,
  [in]      String              OtherUsageDescription,
  [in, out] UInt64              Size,
  [in]      Boolean             UseMaximumSize,
  [in]      UInt16              NumberOfDataCopies,
  [in]      UInt16              PhysicalDiskRedundancy,
  [in]      UInt16              NumberOfColumns,
  [in]      UInt64              Interleave,
  [in]      UInt16              ParityLayout,
  [in]      Boolean             RequestNoSinglePointOfFailure,
  [in]      Boolean             IsEnclosureAware,
  [in]      UInt16              ProvisioningType,
  [in]      Boolean             RunAsJob,
  [out]     String              CreatedVirtualDisk,
  [out]     MSFT_StorageJob REF CreatedStorageJob,
  [out]     String              ExtendedStatus
);

Paramètres

FriendlyName [in]

Nom convivial du disque virtuel.

Les noms conviviaux sont censés être descriptifs, mais ils ne doivent pas nécessairement être uniques. Notez que certains sous-systèmes de stockage n’autorisent pas la définition d’un nom convivial lors de la création d’un disque virtuel. Si un sous-système ne prend pas en charge cela, la création de disque virtuel doit toujours réussir, mais un autre nom peut être attribué au disque.

Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

Utilisation [in]

Spécifie l’utilisation prévue pour le disque virtuel.

Vous pouvez spécifier une description prédéfinie ou une description personnalisée. Pour spécifier une description prédéfinie, utilisez une valeur autre que Autre.

Pour spécifier une description personnalisée, utilisez Other et spécifiez une valeur non NULL pour le paramètre OtherUsageDescription .

Autre (1)

Sans restriction (2)

Réservé à ComputerSystem (le serveur de blocs) (3)

Réservé par les services de réplication (4)

Réservé par Migration Services (5)

Source de réplica local (6)

Source de réplica distant (7)

Cible de réplica local (8)

Cible de réplica distant (9)

Source ou cible du réplica local (10)

Source ou cible du réplica distant (11)

Cible de réplica Delta (12)

Composant d’élément (13)

Réservé en tant que contributeur de pool (14)

Membre de volume composite (15)

Membre VirtualDisk composite (16)

Réservé à l’sparing (17)

OtherUsageDescription [in]

Une utilisation spécifique au fournisseur pour le nouveau disque virtuel. Ce paramètre ne peut être spécifié que si le paramètre Usage est défini sur Autre.

Taille [in, out]

Taille souhaitée, en octets, du disque virtuel. Notez que certains sous-systèmes de stockage arrondiront la taille vers le haut ou vers le bas à un multiple de sa taille d’unité d’allocation.

Le sous-système de stockage utilise ce paramètre uniquement si le paramètre UseMaximumSize est FALSE ou NULL.

Si le paramètre UseMaximumSize a la valeur TRUE, ce paramètre est ignoré.

Ce paramètre est obligatoire et ne peut pas être égal à zéro.

UseMaximumSize [in]

Si la valeur est TRUE, utilisez la taille maximale disponible pour créer le disque virtuel.

Ce paramètre ne peut pas être utilisé avec le paramètre Size .

NumberOfDataCopies [in]

Nombre de copies de données complètes à gérer pour ce disque virtuel.

PhysicalDiskRedundancy [in]

Nombre de défaillances de disque physique que le disque virtuel doit être en mesure de supporter avant la perte de données.

NumberOfColumns [in]

Nombre de disques physiques sous-jacents sur lesquels les données doivent être réparties. Ce paramètre est obligatoire.

Entrelacer [in]

Nombre d’octets qui doivent être attribués à une bande dans les paramètres courants de résilience basés sur le striping. La bande est définie comme la taille de la partie d’une bande qui se trouve sur un disque physique. Ainsi , l’interleave * NumberOfColumns donnera la taille d’une bande. Ce paramètre est obligatoire.

ParityLayout [in]

Si un paramètre de résilience basé sur la parité est souhaité, définissez ce paramètre sur l’une des valeurs suivantes.

Si le paramètre de résilience souhaité n’est pas basé sur la parité, cette propriété doit avoir la valeur NULL.

Parité non rotative (1)

Parité pivotée (2)

RequestNoSinglePointOfFailure [in]

Définissez sur TRUE pour ne demander aucun point de défaillance unique.

IsEnclosureAware [in]

Comportement d’allocation pour ce disque virtuel. Les disques virtuels prenant en charge les boîtiers sélectionnent intelligemment les disques physiques à utiliser pour leur redondance. Si la valeur est TRUE, le disque virtuel tente d’utiliser des disques physiques provenant de différents boîtiers pour équilibrer la tolérance de panne entre deux boîtiers physiques ou plus.

ProvisioningType [in]

Type d’approvisionnement du disque virtuel.

Mince (1)

Correction (2)

RunAsJob [in]

Si la valeur est TRUE, cette méthode utilise le paramètre CreatedStorageJob lorsque le service de la requête prend beaucoup de temps. Si un travail de stockage a été créé pour suivre l’opération, cette méthode retourne les paramètres de la méthode Vérifié - Travail démarré.

Si la valeur est FALSE ou NULL, cette méthode suit le comportement asynchrone WMI par défaut, tel que déterminé par la méthode d’appel du client. En d’autres termes, il est synchrone, sauf demande contraire.

CreatedVirtualDisk [out]

Si le disque virtuel est correctement créé, ce paramètre reçoit une chaîne qui contient un objet MSFT_VirtualDisk incorporé.

CreatedStorageJob [out]

Si RunAsJob a la valeur TRUE et que l’exécution de cette méthode prend beaucoup de temps, ce paramètre reçoit une référence à l’objet de travail de stockage utilisé pour suivre l’opération de longue durée.

ExtendedStatus [out]

Chaîne qui contient un objet MSFT_StorageExtendedStatus incorporé.

Ce paramètre permet au fournisseur de stockage de retourner des informations d’erreur étendues (spécifiques à l’implémentation).

Valeur retournée

Réussite (0)

Non pris en charge (1)

Erreur non spécifiée (2)

Délai d’expiration (3)

Échec (4)

Paramètre non valide (5)

Paramètres de méthode vérifiés - Travail démarré (4096)

Taille non prise en charge (4097)

Espace libre insuffisant (40000)

Accès refusé (40001)

Il n’y a pas suffisamment de ressources pour terminer l’opération. (40002)

Cache obsolète (40003)

Vous devez spécifier une taille à l’aide du paramètre Size ou UseMaximumSize. Vous ne pouvez spécifier qu’un seul de ces paramètres à la fois. (40005)

Impossible de se connecter au fournisseur de stockage. (46000)

Le fournisseur de stockage ne peut pas se connecter au sous-système de stockage. (46001)

Aucun pool de stockage pouvant prendre en charge cette configuration de disque virtuel n’a été trouvé. (47000)

La valeur de NoSinglePointOfFailure n’est pas prise en charge. (49001)

La valeur de PhysicalDiskRedundancy est en dehors de la plage de valeurs prise en charge. (49002)

La valeur de NumberOfDataCopies est en dehors de la plage de valeurs prise en charge. (49003)

La valeur de ParityLayout est en dehors de la plage de valeurs prise en charge. (49004)

La valeur de Interleave est en dehors de la plage de valeurs prise en charge. (49005)

La valeur de NumberOfColumns est en dehors de la plage de valeurs prise en charge. (49006)

Remarques

Cette méthode est généralement utilisée lorsque l’une des conditions suivantes est vraie :

• Les pools de stockage du sous-système de stockage n’autorisent pas directement la création de disques virtuels.
• Le sous-système de stockage ne prend pas en charge les pools de stockage.

Les fournisseurs de gestion du stockage peuvent également choisir d’implémenter cette méthode pour choisir « intelligemment » un pool de stockage pour l’utilisateur. Si cette méthode est prise en charge, la propriété SupportsAutomaticStoragePoolSelection du sous-système doit avoir la valeur TRUE.

Configuration requise

Voir aussi

MSFT_StorageSubSystem