New-StorageTier
New-StorageTier
Creates a storage tier.
Syntax
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>]
Detaillierte Beschreibung
The New-StorageTier cmdlet creates a storage tier in a storage pool.
Parameter
-AsJob
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-CimSession<CimSession[]>
Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.
Aliasse |
Session |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Description<String>
Specifies a description for the storage tier that you create.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-FriendlyName<String>
Specifies a friendly name for the storage tier.
Aliasse |
StorageTierFriendlyName |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-InputObject<CimInstance[]>
Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe über die Pipeline an dieses Cmdlet übergeben.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-MediaType<MediaType>
Specifies the media type of the storage tier. The cmdlet creates the storage tier for the media type that you specify. Die folgenden Werte für diesen Parameter sind zulässig:
-- SSD
-- HDD
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
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.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
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.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
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.
Aliasse |
StoragePoolId |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-ThrottleLimit<Int32>
Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.
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.
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
Microsoft.Management.Infrastructure.CimInstance#root/microsoft/windows/storage/MSFT_StorageTier
This cmdlet outputs an object that represents the storage tier
Beispiele
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