MSFT_StorageSubSystem クラスの CreateVirtualDisk メソッド
新しい仮想ディスクを作成します。
構文
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
);
パラメーター
FriendlyName [in]
仮想ディスクのフレンドリ名。
フレンドリ名はわかりやすいものであることが必要ですが、一意である必要はありません。 一部のストレージ サブシステムでは、仮想ディスクの作成時にフレンドリ名を設定できません。 サブシステムがこれをサポートしていない場合でも、仮想ディスクの作成は成功するはずですが、ディスクに別の名前が割り当てられている可能性があります。
このパラメーターは必須であり、NULL にすることはできません。
Usage [in]
仮想ディスクの使用目的を指定します。
定義済みの説明またはカスタムの説明を指定できます。 定義済みの説明を指定するには、Other 以外の値を使用します。
カスタムの説明を指定するには、Other を使用し、NULL 以外の値を OtherUsageDescription パラメーターに指定します。
Other (1)
Unrestricted (2)
Reserved for ComputerSystem (the block server) (3)
Reserved by Replication Services (4)
Reserved by Migration Services (5)
Local Replica Source (6)
Remote Replica Source (7)
Local Replica Target (8)
Remote Replica Target (9)
Local Replica Source or Target (10)
Remote Replica Source or Target (11)
Delta Replica Target (12)
Element Component (13)
Reserved as Pool Contributor (14)
Composite Volume Member (15)
Composite VirtualDisk Member (16)
Reserved for Sparing (17)
OtherUsageDescription [in]
新しい仮想ディスクのベンダー固有の使用方法。 このパラメーターは、Usage パラメーターが Other に設定された場合にのみ指定できます。
Size [in, out]
仮想ディスクの望ましいサイズ (バイト単位) 一部のストレージ サブシステムでは、サイズが割り当てユニット サイズの倍数に切り上げまたは切り下げされることに注意してください。
ストレージ サブシステムは、UseMaximumSize パラメーターが FALSE または NULL の場合のみ、このパラメーターを使用します。
UseMaximumSize パラメーターが TRUE の場合、このパラメーターは無視されます。
このパラメーターは必須であり、ゼロにすることはできません。
UseMaximumSize [in]
TRUE の場合は、仮想ディスクの作成に使用できる最大サイズを使用します。
このパラメーターを Size パラメーターと共に使用することはできません。
NumberOfDataCopies [in]
この仮想ディスクのために維持される完全なデータ コピーの数。
PhysicalDiskRedundancy [in]
データ損失が発生する前に仮想ディスクが耐えられる必要がある物理ディスク障害の数。
NumberOfColumns [in]
データをストライピングする基になる物理ディスクの数。 このパラメーターは必須です。
Interleave [in]
一般的なストライピングベースの回復性設定でストリップに必要なバイト数。 ストリップは、1 つの物理ディスク上にあるストライプの部分のサイズとして定義されます。 したがって、Interleave * NumberOfColumns は 1 つのストライプのサイズになります。 このパラメーターは必須です。
ParityLayout [in]
パリティ ベースの回復性設定が必要な場合は、このパラメーターを次のいずれかの値に設定します。
必要な回復性設定がパリティ ベースでない場合、このプロパティは NULL である必要があります。
Non-rotated Parity (1)
Rotated Parity (2)
RequestNoSinglePointOfFailure [in]
単一障害点がないことを要求するには、TRUE に設定します。
IsEnclosureAware [in]
この仮想ディスクの割り当て動作。 エンクロージャ対応の仮想ディスクは、冗長性のために使用する物理ディスクをインテリジェントに選択します。 TRUE の場合、仮想ディスクは異なるエンクロージャの物理ディスクを使用して、2 つ以上の物理エンクロージャ間のフォールト トレランスのバランスを取ります。
ProvisioningType [in]
仮想ディスクのプロビジョニングの種類。
Thin (1)
Fixed (2)
RunAsJob [in]
TRUE の場合、このメソッドは、要求のサービスに時間がかかっているときに CreatedStorageJob パラメーターを使用します。 操作を追跡するためにストレージ ジョブが作成されている場合、このメソッドは Method Parameters Checked - Job Started を返します。
Note
RunAsJob が TRUE の場合でも、十分な時間内に終了していれば、このメソッドは結果を返すことができます。
FALSE または NULL の場合、このメソッドは、クライアントの呼び出し方法によって決定される既定の WMI の非同期動作に従います。 つまり、特に要求されない限りは同期です。
CreatedVirtualDisk [out]
仮想ディスクが正常に作成された場合、このパラメーターは埋め込み MSFT_VirtualDisk オブジェクトを含む文字列を受け取ります。
CreatedStorageJob [out]
RunAsJob が TRUE に設定されていて、このメソッドの実行に時間がかかる場合、このパラメーターは、実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を受け取ります。
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)
Cache out of date (40003)
Size または UseMaximumSize パラメーターを使用して、サイズを指定する必要があります。 一度に指定できるのは、これらのパラメーターのどちらか 1 つだけです。 (40005)
ストレージ プロバイダーに接続できません。 (46000)
ストレージ プロバイダーがストレージ サブシステムに接続できません。 (46001)
この仮想ディスク構成をサポートできるストレージ プールが見つかりませんでした。 (47000)
NoSinglePointOfFailure の値はサポートされていません。 (49001)
PhysicalDiskRedundancy の値は、サポートされている値の範囲外です。 (49002)
NumberOfDataCopies の値は、サポートされている値の範囲外です。 (49003)
ParityLayout の値は、サポートされている値の範囲外です。 (49004)
Interleave の値は、サポートされている値の範囲外です。 (49005)
NumberOfColumns の値は、サポートされている値の範囲外です。 (49006)
解説
このメソッドは、通常、次のいずれかが当てはまる場合に使用されます。
- ストレージ サブシステムのストレージ プールでは、仮想ディスクを直接作成することはできません。
- ストレージ サブシステムは、ストレージ プールをサポートしていません。
ストレージ管理プロバイダーは、このメソッドを実装して、ユーザーのストレージ プールを "インテリジェントに" 選択することもできます。 このメソッドがサポートされている場合は、サブシステムの SupportsAutomaticStoragePoolSelection プロパティを TRUE に設定する必要があります。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |