New-StorageTier
New-StorageTier
Creates a storage tier.
語法
Parameter Set: ByFriendlyName
New-StorageTier [-StoragePoolFriendlyName] <String[]> -FriendlyName <String> -MediaType <MediaType> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByName
New-StorageTier -FriendlyName <String> -MediaType <MediaType> -StoragePoolName <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByUniqueId
New-StorageTier -FriendlyName <String> -MediaType <MediaType> -StoragePoolUniqueId <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: InputObject (cdxml)
New-StorageTier -FriendlyName <String> -InputObject <CimInstance[]> -MediaType <MediaType> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
詳細描述
The New-StorageTier cmdlet creates a storage tier in a storage pool.
參數
-AsJob
別名 |
無 |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-CimSession<CimSession[]>
在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件,例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。
別名 |
Session |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-Description<String>
Specifies a description for the storage tier that you create.
別名 |
無 |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-FriendlyName<String>
Specifies a friendly name for the storage tier.
別名 |
StorageTierFriendlyName |
必要? |
true |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-InputObject<CimInstance[]>
指定對這個 Cmdlet 的輸入。您可以使用這個參數,或是透過管道提供輸入給這個 Cmdlet。
別名 |
無 |
必要? |
true |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
True (ByValue) |
接受萬用字元? |
false |
-MediaType<MediaType>
Specifies the media type of the storage tier. The cmdlet creates the storage tier for the media type that you specify. 此參數接受的值包括:
-- SSD
-- HDD
別名 |
無 |
必要? |
true |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-StoragePoolFriendlyName<String[]>
Specifies an array of friendly names of storage pools. The cmdlet creates the storage tier in the storage pools that you specify.
別名 |
無 |
必要? |
true |
位置? |
1 |
預設值 |
無 |
接受管線輸入? |
True (ByPropertyName) |
接受萬用字元? |
false |
-StoragePoolName<String[]>
Specifies an array of names of storage pools. The cmdlet creates the storage tier in the storage pools that you specify. This human-readable name is not necessarily unique.
別名 |
無 |
必要? |
true |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
True (ByPropertyName) |
接受萬用字元? |
false |
-StoragePoolUniqueId<String[]>
Specifies an array of unique IDs, as strings, of storage pools. The cmdlet creates the storage tiers in the storage pools that have the IDs that you specify.
別名 |
StoragePoolId |
必要? |
true |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
True (ByPropertyName) |
接受萬用字元? |
false |
-ThrottleLimit<Int32>
指定為執行此 Cmdlet 可建立的最大同時作業數。如果省略這個參數或輸入 0
的值,則 Windows PowerShell® 會根據在電腦上執行的 CIM Cmdlet 數目,計算 Cmdlet 的最佳節流限制。節流限制僅適用於目前 Cmdlet,不適用於工作階段或電腦。
別名 |
無 |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
此 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 與 -OutVariable。如需詳細資訊,請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
輸入
輸入類型是您可以使用管線處理方式傳遞給 Cmdlet 的物件類型。
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool
You can use the pipeline operator to pass a MSFT_StoragePool object to the InputObject parameter.
輸出
輸出類型是 Cmdlet 所發出的物件類型。
Microsoft.Management.Infrastructure.CimInstance#root/microsoft/windows/storage/MSFT_StorageTier
This cmdlet outputs an object that represents the storage tier
範例
Example 1: Create a storage tier
This command creates a storage tier for hard disk drives named Tier11 in the storage pool named TierPool01.
PS C:\> New-StorageTier -StoragePoolFriendlyName "TierPool01" -FriendlyName "Standard_HDD_Tier" -MediaType HDD