ストレージ プールのリソースを使用して、仮想ディスクと単一ボリュームを作成します。
構文
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
);
パラメーター
FriendlyName [in]
ボリュームのフレンドリ名。 フレンドリ名は、ボリュームを説明する名前である必要があります。 一意である必要はありません。 ファイル システムのラベルも、この名前に設定されます。
このパラメーターは必須であり、NULL にすることはできません。
Size [in]
仮想ディスクのサイズ。 一部のストレージ サブシステムでは、サイズが割り当てユニット サイズの倍数に切り上げまたは切り下げされることに注意してください。 作成されたボリュームのサイズは、この仮想ディスク サイズで可能な限り大きくなります。
StorageTiers [in]
仮想ディスク上のストレージ層。 各配列要素は、MSFT_StorageTier オブジェクトです。
StorageTierSizes [in]
層のサイズ。
ProvisioningType [in]
ボリュームのプロビジョニング タイプ。
| Value | 意味 |
|---|---|
| 1 | 仮想プロビジョニング - ボリュームのストレージはオンデマンドで割り当てられます。 |
| 2 | 固定プロビジョニング - ボリュームのストレージは、ボリュームの作成時に割り当てられます。 |
ResiliencySettingName [in]
ボリュームのテンプレートとして使用する回復性設定の名前。 これは、回復性設定インスタンスの Name プロパティと同じです。 このストレージ プールに関連付けられている回復性設定のみを使用できます。
PhysicalDiskRedundancy [in]
仮想ディスクがデータ損失なしで耐えられる物理ディスク障害の数。 指定しなかった場合、使用される値は、ResiliencySettingName によって指定された回復性設定の PhysicalDiskRedundancyDefault メンバーです。
NumberOfColumns [in]
データのストライプに使用する物理ディスクの数。 指定しなかった場合、使用される値は、ResiliencySettingName によって指定された回復性設定の NumberOfColumnsDefault メンバーです。
FileSystem [in]
作成されたボリュームで使用するファイル システムの種類。 CSV ファイル システムは、ストレージ スペース サブシステムでのみサポートされます。 CSV の場合、プールはクラスター化可能である必要があり、作成されるボリュームはクラスター共有ボリュームになります。
このパラメーターは必須であり、NULL にすることはできません。
| Value | 意味 |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
ボリュームへのローカル アクセス パス。 アクセス パスを設定できなかった場合、またはこのパラメーターが NULL の場合は、新しいアクセス パスが割り当てられます。
FileServer [in]
Windows 10 以降: このボリュームを所有するファイル サーバーを表す埋め込み MSFT_FileServer オブジェクトを含む文字列。
CreatedVolume [out]
作成されたボリューム、MSFT_Volume オブジェクト。
CreatedStorageJob [out]
実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を返します。
ExtendedStatus [out]
MSFT_StorageExtendedStatus オブジェクト内の拡張エラー情報。 この情報は実装固有です。
戻り値
Success (0)
Not Supported (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Method Parameters Checked - Job Started (4096)
サイズがサポートされていません (4097)
Not enough free space (40000)
Access denied (40001)
リソース不足のため、操作を完了できません。 (40002)
予期しない I/O エラーが発生しました。 (40004)
Size または UseMaximumSize パラメーターを使用して、サイズを指定する必要があります。 一度に指定できるのは、これらのパラメーターのどちらか 1 つだけです。 (40005)
要求されたアクセス パスは既に使用されています。 (42002)
アクセス パスが有効ではありません。 (42007)
指定されたファイル システムはサポートされていません。 (43001)
ボリュームを迅速にフォーマットすることはできません。 (43002)
ドライブが読み取り専用の場合、要求された操作を実行できません。 (43006)
このボリュームの名前を指定する必要があります。 (43017)
このボリュームを公開するファイル サーバーを指定する必要があります。 (43018)
ボリュームは、指定されたファイル サーバーに公開されません。 (43019)
ストレージ プロバイダーに接続できません。 (46000)
ストレージ プロバイダーがストレージ サブシステムに接続できません。 (46001)
このストレージ オブジェクトに対してフェールオーバー クラスタリングを有効にできませんでした。 (46008)
この操作は、プリモディアル ストレージ プールではサポートされていません。 (48000)
ストレージ プールは特別な用途専用に予約されています。 (48001)
指定された回復性設定は、このストレージ プールではサポートされていません。 (48002)
ストレージ プールに十分な物理ディスクがないため、指定された仮想ディスク構成を作成できません。 (48004)
ストレージ プールの正常性状態または動作状態により、操作を完了できませんでした。 (48006)
ストレージ プールの構成が読み取り専用であるため、操作を完了できませんでした。 (48007)
サイズ情報 (Size または UseMaximumSize パラメーター) または階層情報 (StorageTiers および StorageTierSizes パラメーター) を指定する必要がありますが、サイズ情報と階層情報の両方は指定しないでください。 (48010)
その名前の回復性設定は存在しません。 (49000)
NoSinglePointOfFailure の値はサポートされていません。 (49001)
PhysicalDiskRedundancy の値は、サポートされている値の範囲外です。 (49002)
NumberOfDataCopies の値は、サポートされている値の範囲外です。 (49003)
ParityLayout の値は、サポートされている値の範囲外です。 (49004)
Interleave の値は、サポートされている値の範囲外です。 (49005)
NumberOfColumns の値は、サポートされている値の範囲外です。 (49006)
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |