MSFT_StorageSubSystem 類別的 CreateStoragePool 方法

  • 發行項

從一般原始集區中包含的可用實體磁碟建立存放集區。

如果實體磁碟的 MSFT_PhysicalDisk 物件的 CanPool 屬性為 TRUE，則可以建立存放集區。

只有在記憶體子系統MSFT_StorageSubSystem物件的 SupportsStoragePoolCreation 屬性為 TRUE 時，才能建立存放集區。

語法

UInt32 CreateStoragePool(
  [in]  String              FriendlyName,
  [in]  UInt16              Usage,
  [in]  String              OtherUsageDescription,
  [in]  String              PhysicalDisks[],
  [in]  String              ResiliencySettingNameDefault,
  [in]  UInt16              ProvisioningTypeDefault,
  [in]  UInt64              LogicalSectorSizeDefault,
  [in]  Boolean             EnclosureAwareDefault,
  [in]  UInt64              WriteCacheSizeDefault,
  [in]  Boolean             AutoWriteCacheSize,
  [in]  Boolean             RunAsJob,
  [out] String              CreatedStoragePool,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              ExtendedStatus
);

參數

FriendlyName [in]

指定新存放集區的易記名稱。

易記名稱必須是描述性名稱，但不需要是唯一的。 請注意，某些記憶體子系統不允許在集區建立期間設定易記名稱。

如果子系統不支援此功能，則存放集區建立仍然應該會成功。 不過，集區可能會指派不同的名稱。

這個參數是必要的，而且不能是 NULL。

使用量 [in]

指定存放集區的預定使用量。

您可以指定預先定義的描述或自訂描述。 若要指定預先定義的描述， 請使用 Other 以外的值。

若要指定自定義描述，請使用 Other 並指定 OtherUsageDescription 參數的非 NULL 值。

其他 (1)

不受限制 (2)

保留給 ComputerSystem (區塊伺服器) ( 3)

保留為差異復本容器 (4)

保留給移轉服務 (5)

保留給本機復寫服務 (6)

保留給遠端復寫服務 (7)

保留給疏 ( 8)

OtherUsageDescription [in]

允許使用者為新的 MSFT_StoragePool 物件設定自定義使用類型。 只有當 Usage 參數設定為 [其他] 時，才能指定此參數。

PhysicalDisks [in]

字串數位，每個字串都包含 MSFT_PhysicalDisk 類別的內嵌實例。

此參數是用來指定 MSFT_PhysicalDisk 對象的陣列，這些物件將用來作為新建立存放集區的備份數據記憶體。 實體磁碟必須來自您要在其中建立此集區的子系統中原始集區。 所有實體磁碟都必須來自相同的原始集區。

這個參數是必要的，而且不能是 NULL。

ResiliencySettingNameDefault [in]

在此存放集區中建立新的虛擬磁碟時，預設要使用的復原設定。 如果子系統的 SupportsMultipleResiliencySettingsPerStoragePool 屬性設定為 FALSE，此參數也會作為此存放集區應繼承復原設定之記憶體管理提供者的提示。 如果未指定任何值，記憶體管理提供者會負責選擇最適當的復原設定。

ProvisioningTypeDefault [in]

在此存放集區上建立新的虛擬磁碟時，預設要使用的布建類型。 如果此參數為零，預設布建類型會繼承自原始集區。

細 (1)

已 修正 (2)

LogicalSectorSizeDefault [in]

默認邏輯扇區大小，以位元組為單位。 當存放集區可能包含仿真的 512 位元組混合，以及 4K 位元組原生或 512 位元組原生實體磁碟時，這非常有用。

EnclosureAwareDefault [in]

在機箱感知存放集區中建立之虛擬磁碟的預設配置原則。 例如，機箱感知的子系統可平衡跨多個實體機箱之虛擬磁碟的每個資料複本，因此，每個機箱都會包含虛擬磁碟的完整資料複本。

WriteCacheSizeDefault [in]

建立虛擬磁碟之寫入快取的預設大小。

AutoWriteCacheSize [in]

如果 為 TRUE，提供者應該挑選自動寫入快取大小。

RunAsJob [in]

如果 為 TRUE，這個方法會在要求花費很長的時間進行服務時，使用 CreatedStorageJob 參數。 如果已建立記憶體作業以追蹤作業，這個方法會傳回 [已檢查的方法參數 - 作業已啟動]。

注意

即使 RunAsJob 為 TRUE，這個方法仍可在有足夠的時間完成時傳回結果。

如果 為 FALSE 或 NULL，這個方法會遵循用戶端的 叫用方法所決定的預設 WMI 異步行為。 換句話說，除非另有要求，否則它是同步的。

CreatedStoragePool [out]

如果已成功建立存放集區，此參數會接收包含內嵌 MSFT_StoragePool 物件的字串。

CreatedStorageJob [out]

如果 RunAsJob 設定為 TRUE ，而且這個方法需要很長的時間才能執行，這個參數會接收用來追蹤長時間執行作業的記憶體作業對象的參考。

ExtendedStatus [out]

包含內嵌 MSFT_StorageExtendedStatus 物件的字串。

此參數可讓記憶體提供者傳回擴充 (實作特定) 錯誤資訊。

傳回值

成功 (0)

不支援 (1)

未指定的錯誤 (2)

逾 時 (3)

失敗 (4)

無效的參數 (5)

找不到物件 (8)

已檢查方法參數 - 作業啟動 (4096)

拒絕存取 (40001)

沒有足夠的資源來完成作業。 (40002)

快取過期 (40003)

發生非預期的 I/O 錯誤 (40004)

要求失敗，因為發生嚴重裝置硬體錯誤。 (40007)

無法連線到記憶體提供者。 (46000)

記憶體提供者無法連線到記憶體子系統。 (46001)

無法為此記憶體物件啟用故障轉移叢集。 (46008)

沒有具有該名稱的復原設定。 (49000)

WriteCacheSize 的值超出支援的值範圍。 (50005)

此作業不支援指定的其中一個實體磁碟。 (51000)

指定的實體磁碟不足，無法順利完成作業。 (51001)

指定的其中一個實體磁碟已在使用中。 (51002)

指定的其中一個實體磁碟會使用此存放集區不支援的扇區大小。 (51003)

一或多個實體磁碟未連線到要建立集區的節點。 (51005)

備註

不支援存放集區的子系統應該實作此方法，如下所示：

支援存放集區的子系統，但不允許選取存放集區 (建立虛擬磁碟的系統管理員選取，) 、建立、修改或刪除，應實作此方法，如下所示：

支援存放集區和存放集區選取但不支援儲存集區建立、修改或刪除的子系統應該實作此方法，如下所示：

支援存放集區和存放集區選取的子系統，也支援儲存集區建立、修改或刪除的子系統應該實作此方法，如下所示：

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
命名空間 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另請參閱

MSFT_StorageSubSystem