Get-StorageTier
Get-StorageTier
Gets storage tiers on Storage Spaces subsystems.
Syntaxe
Parameter Set: ByFriendlyName
Get-StorageTier [[-FriendlyName] <String[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-MediaType <MediaType[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByStoragePool
Get-StorageTier [-AsJob] [-CimSession <CimSession[]> ] [-MediaType <MediaType[]> ] [-StoragePool <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByUniqueId
Get-StorageTier [-AsJob] [-CimSession <CimSession[]> ] [-MediaType <MediaType[]> ] [-ThrottleLimit <Int32> ] [-UniqueId <String[]> ] [ <CommonParameters>]
Parameter Set: ByVirtualDisk
Get-StorageTier [-AsJob] [-CimSession <CimSession[]> ] [-MediaType <MediaType[]> ] [-ThrottleLimit <Int32> ] [-VirtualDisk <CimInstance> ] [ <CommonParameters>]
Description détaillée
The Get-StorageTier gets storage tiers on Storage Spaces subsystems. Storage tiers are physical disks that are grouped by characteristics, for example, solid-state drives (SSD) and hybrid hard drives (HHD).
Paramètres
-AsJob
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-CimSession<CimSession[]>
Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, comme la sortie d’une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.
Alias |
Session |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-FriendlyName<String[]>
Specifies an array of friendly names of storage tiers to get.
Alias |
none |
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-MediaType<MediaType[]>
Specifies an array of media types. The cmdlet gets the storage tiers for the media type that you specify. Les valeurs acceptables pour ce paramètre sont :
-- SSD
-- HDD
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-StoragePool<CimInstance>
Specifies a storage pool as a CIMInstance object. The cmdlet gets the storage tiers for the storage pool that you specify. To obtain a storage pool, use the Get-StoragePool cmdlet.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByValue) |
Accepter les caractères génériques ? |
false |
-ThrottleLimit<Int32>
Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter cette applet de commande. Si ce paramètre est omis ou si la valeur 0
est entrée, Windows PowerShell ® calcule une limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limitation s’applique seulement à l’applet de commande actuelle, et non pas à la session ni à l’ordinateur.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-UniqueId<String[]>
Specifies an array of IDs of storage tiers to get.
Alias |
Id |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-VirtualDisk<CimInstance>
Specifies a virtual disk as a CIMInstance object. The cmdlet gets the storage tiers for the virtual disk that you specify. To obtain a virtual disk, use theGet-VirtualDisk cmdlet.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByValue) |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool
You can use the pipeline operator to pass an MSFT_StoragePool object to the StoragePool parameter to get the storage tier associated with the StoragePool object.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_VirtualDisk
You can use the pipeline operator to pass an MSFT_VirtualDisk object to the VirtualDisk parameter to get the storage tier associated with the VirtualDisk object.
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
-
This cmdlet returns an object that contains details about the storage tier, such as tier friendly name, media type and size.
Exemples
Example 1: Get a storage tier
This command gets the storage tier named StoreTier01.
PS C:\> Get-StorageTier -FriendlyName "StoreTier01"
Example 2: Get a storage tier from a storage pool
This command gets the object that contains the storage pool named StorePool01, and then passes the object to the Get-StorageTier cmdlet by using the pipeline operator. The Get-StorageTier cmdlet gets the storage tier from the storage pool object.
PS C:\> Get-StoragePool -StoragePoolFriendlyName "StorePool01" | Get-StorageTier
Example 3: Get a storage tier from a virtual disk
This command uses the Get-VirtualDisk cmdlet to get the tiered virtual disk named VDisk01. The command passes the virtual disk to the Get-StorageTier cmdlet by using the pipeline operator. The Get-StorageTier cmdlet gets the storage tiers that compose the tiered virtual disk.
PS C:\> Get-VirtualDisk-FriendlyName "VDisk01" | Get-StorageTier