Metodo CreateVolume della classe MSFT_StoragePool
Crea un disco virtuale e un singolo volume usando le risorse del pool di archiviazione.
Sintassi
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
);
Parametri
FriendlyName [in]
Nome descrittivo del volume. Il nome descrittivo deve descrivere il volume. Non deve essere univoco. L'etichetta del file system verrà impostata anche su questo nome.
Questo parametro è obbligatorio e non può essere NULL.
Dimensioni [in]
Dimensioni del disco virtuale. Si noti che alcuni sottosistemi di archiviazione arrotonderanno le dimensioni fino a un multiplo delle dimensioni dell'unità di allocazione. Le dimensioni del volume creato saranno pari a quanto consentite da questa dimensione del disco virtuale.
StorageTiers [in]
Livelli di archiviazione nel disco virtuale. Ogni elemento matrice è un oggetto MSFT_StorageTier .
StorageTierSizes [in]
Dimensioni dei livelli.
ProvisioningType [in]
Tipo di provisioning del volume.
| Valore | Significato |
|---|---|
| 1 | Thin provisioning: l'archiviazione per il volume viene allocata su richiesta. |
| 2 | Correzione del provisioning: l'archiviazione per il volume viene allocata al momento della creazione del volume. |
ResiliencySettingName [in]
Nome dell'impostazione di resilienza da usare come modello per questo volume. Equivale alla proprietà Name dell'istanza dell'impostazione di resilienza. È possibile usare solo le impostazioni di resilienza associate a questo pool di archiviazione.
PhysicalDiskRedundancy [in]
Numero di errori del disco fisico che il disco virtuale può sopportare senza perdita di dati. Se non specificato, il valore usato è il membro PhysicalDiskRedundancyDefault dell'impostazione di resilienza specificata da ResiliencySettingName.
NumberOfColumns [in]
Numero di dischi fisici da usare per eseguire lo striping dei dati. Se non specificato, il valore usato è il membro NumberOfColumnsDefault dell'impostazione di resilienza specificata da ResiliencySettingName.
FileSystem [in]
Tipo di file system da utilizzare nel volume creato. Un file system CSV è supportato solo in un sottosistema spazi di archiviazione. Per csv il pool deve essere clusterable e il volume creato sarà un volume condiviso del cluster.
Questo parametro è obbligatorio e non può essere NULL.
| Valore | Significato |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
Percorso di accesso locale al volume. Se non è stato possibile impostare il percorso di accesso o questo parametro è NULL, verrà assegnato un nuovo percorso di accesso.
FileServer [in]
A partire da Windows 10: stringa che contiene un oggetto MSFT_FileServer incorporato, che rappresenta il file server proprietario di questo volume.
CreatedVolume [out]
Volume creato, oggetto MSFT_Volume .
CreatedStorageJob [out]
Restituisce un riferimento all'oggetto processo di archiviazione utilizzato per tenere traccia dell'operazione a esecuzione prolungata.
ExtendedStatus [out]
Informazioni estese sugli errori in un oggetto MSFT_StorageExtendedStatus . Le informazioni sono specifiche dell'implementazione.
Valore restituito
Operazione riuscita (0)
Non supportato (1)
Errore non specificato (2)
Timeout (3)
Non riuscito (4)
Parametro non valido (5)
Parametri del metodo controllati - Processo avviato (4096)
Dimensioni non supportate (4097)
Spazio disponibile insufficiente (40000)
Accesso negato (40001)
Non sono disponibili risorse sufficienti per completare l'operazione. (40002)
Si è verificato un errore di I/O imprevisto. (40004)
È necessario specificare una dimensione utilizzando il parametro Size o UseMaximumSize . È possibile specificare solo uno di questi parametri alla volta. (40005)
Il percorso di accesso richiesto è già in uso. (42002)
Il percorso di accesso non è valido. (42007)
Il file system specificato non è supportato. (43001)
Impossibile formattare rapidamente il volume. (43002)
Impossibile eseguire l'operazione richiesta quando l'unità è di sola lettura. (43006)
È necessario specificare un nome per questo volume. (43017)
È necessario specificare un file server in cui esporre questo volume. (43018)
Il volume non è esposto al file server specificato. (43019)
Impossibile connettersi al provider di archiviazione. (46000)
Il provider di archiviazione non può connettersi al sottosistema di archiviazione. (46001)
Impossibile abilitare il clustering di failover per questo oggetto di archiviazione. (46008)
Questa operazione non è supportata nei pool di archiviazione primordiali. (48000)
Il pool di archiviazione è riservato solo per utilizzo speciale. (48001)
L'impostazione di resilienza specificata non è supportata da questo pool di archiviazione. (48002)
Non sono presenti dischi fisici sufficienti nel pool di archiviazione per creare la configurazione del disco virtuale specificata. (48004)
Il pool di archiviazione non è riuscito a completare l'operazione perché lo stato di integrità o operativo non lo consente. (48006)
Il pool di archiviazione non è riuscito a completare l'operazione perché la configurazione è di sola lettura. (48007)
È necessario specificare le informazioni sulle dimensioni (il parametro Size o UseMaximumSize ) o le informazioni sul livello (i parametri StorageTiers eStorageTierSizes ), ma non sia le informazioni sulle dimensioni che le informazioni sul livello. (48010)
Nessuna impostazione di resilienza con tale nome esiste. (49000)
Il valore di NoSinglePointOfFailure non è supportato. (49001)
Il valore di PhysicalDiskRedundancy non rientra nell'intervallo di valori supportato. (49002)
Il valore per NumberOfDataCopies non rientra nell'intervallo di valori supportato. (49003)
Il valore di ParityLayout non rientra nell'intervallo di valori supportato. (49004)
Il valore di Interleave non rientra nell'intervallo di valori supportato. (49005)
Il valore per NumberOfColumns non rientra nell'intervallo di valori supportato. (49006)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 R2 [solo app desktop] |
| Spazio dei nomi | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |