Méthode CreateVolume de la classe MSFT_StoragePool
Crée un disque virtuel et un volume unique à l’aide des ressources du pool de stockage.
Syntaxe
UInt32 CreateVolume(
[in] String FriendlyName,
[in] UInt64 Size,
[in] String StorageTiers[],
[in] UInt64 StorageTierSizes[],
[in] UInt16 ProvisioningType,
[in] String ResiliencySettingName,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt16 FileSystem,
[in] String AccessPath,
[in] String FileServer,
[out] String CreatedVolume,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Paramètres
FriendlyName [in]
Nom convivial du volume. Le nom convivial doit décrire le volume. Il n’a pas besoin d’être unique. L’étiquette du système de fichiers sera également définie sur ce nom.
Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
Taille [in]
Taille 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. La taille du volume créé sera aussi grande que cette taille de disque virtuel le permet.
StorageTiers [in]
Niveaux de stockage sur le disque virtuel. Chaque élément de tableau est un objet MSFT_StorageTier .
StorageTierSizes [in]
Tailles des niveaux.
ProvisioningType [in]
Type d’approvisionnement du volume.
| Valeur | Signification |
|---|---|
| 1 | Approvisionnement léger : le stockage du volume est alloué à la demande. |
| 2 | Provisionnement fixe : le stockage du volume est alloué lors de la création du volume. |
ResiliencySettingName [in]
Nom du paramètre de résilience à utiliser comme modèle pour ce volume. Il est identique à la propriété Name du paramètre de résilience instance. Seuls les paramètres de résilience associés à ce pool de stockage peuvent être utilisés.
PhysicalDiskRedundancy [in]
Nombre de défaillances de disque physique auxquelles le disque virtuel peut résister sans perte de données. Si elle n’est pas spécifiée, la valeur utilisée est le membre PhysicalDiskRedundancyDefault du paramètre de résilience spécifié par ResiliencySettingName.
NumberOfColumns [in]
Nombre de disques physiques à utiliser pour l’rayure des données. Si elle n’est pas spécifiée, la valeur utilisée est le membre NumberOfColumnsDefault du paramètre de résilience spécifié par ResiliencySettingName.
FileSystem [in]
Type de système de fichiers à utiliser sur le volume créé. Un système de fichiers CSV est uniquement pris en charge sur un sous-système d’espaces de stockage. Pour csv, le pool doit être clusterable et le volume créé sera un volume partagé de cluster.
Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
| Valeur | Signification |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
Chemin d’accès local au volume. Si le chemin d’accès n’a pas pu être défini ou si ce paramètre a la valeur NULL, un nouveau chemin d’accès est attribué.
FileServer [in]
À partir de Windows 10 : chaîne qui contient un objet MSFT_FileServer incorporé, représentant le serveur de fichiers qui sera propriétaire de ce volume.
CreatedVolume [out]
Volume créé, objet MSFT_Volume .
CreatedStorageJob [out]
Retourne une référence à l’objet de travail de stockage utilisé pour suivre l’opération de longue durée.
ExtendedStatus [out]
Informations d’erreur étendues dans un objet MSFT_StorageExtendedStatus . Les informations sont 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 assez de ressources pour terminer l’opération. (40002)
Une erreur d’E/S inattendue s’est produite. (40004)
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)
Le chemin d’accès demandé est déjà utilisé. (42002)
Le chemin d’accès n’est pas valide. (42007)
Le système de fichiers spécifié n’est pas pris en charge. (43001)
Le volume ne peut pas être mis en forme rapidement. (43002)
Impossible d’effectuer l’opération demandée lorsque le lecteur est en lecture seule. (43006)
Vous devez spécifier un nom pour ce volume. (43017)
Vous devez spécifier un serveur de fichiers auquel exposer ce volume. (43018)
Le volume n’est pas exposé au serveur de fichiers spécifié. (43019)
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)
Le basculement clustering n’a pas pu être activé pour cet objet de stockage. (46008)
Cette opération n’est pas prise en charge sur les pools de stockage primordials. (48000)
Le pool de stockage est réservé à une utilisation spéciale uniquement. (48001)
Le paramètre de résilience spécifié n’est pas pris en charge par ce pool de stockage. (48002)
Le pool de stockage ne contient pas suffisamment de disques physiques pour créer la configuration de disque virtuel spécifiée. (48004)
Le pool de stockage n’a pas pu terminer l’opération, car son intégrité ou son status opérationnelle ne le permet pas. (48006)
Le pool de stockage n’a pas pu terminer l’opération, car sa configuration est en lecture seule. (48007)
Vous devez spécifier les informations de taille (le paramètre Size ou UseMaximumSize ) ou les informations de niveau (les paramètres StorageTiers et StorageTierSizes ), mais pas les informations de taille et de niveau. (48010)
Aucun paramètre de résilience portant ce nom n’existe. (49000)
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 d’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)
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8.1 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 R2 [applications de bureau uniquement] |
| Espace de noms | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |