Get-StorageNode
Get-StorageNode
Gets storage nodes.
Syntaxe
Parameter Set: ByName
Get-StorageNode [-AsJob] [-CimSession <CimSession[]> ] [-Name <String[]> ] [-OperationalStatus <OperationalStatus[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByPhysicalDisk
Get-StorageNode [-AsJob] [-CimSession <CimSession[]> ] [-OperationalStatus <OperationalStatus[]> ] [-PhysicalDisk <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByStorageEnclosure
Get-StorageNode [-AsJob] [-CimSession <CimSession[]> ] [-OperationalStatus <OperationalStatus[]> ] [-StorageEnclosure <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByStoragePool
Get-StorageNode [-AsJob] [-CimSession <CimSession[]> ] [-OperationalStatus <OperationalStatus[]> ] [-StoragePool <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByStorageSubSystem
Get-StorageNode [-AsJob] [-CimSession <CimSession[]> ] [-OperationalStatus <OperationalStatus[]> ] [-StorageSubSystem <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByUniqueId
Get-StorageNode [-AsJob] [-CimSession <CimSession[]> ] [-OperationalStatus <OperationalStatus[]> ] [-ThrottleLimit <Int32> ] [-UniqueId <String[]> ] [ <CommonParameters>]
Parameter Set: ByVirtualDisk
Get-StorageNode [-AsJob] [-CimSession <CimSession[]> ] [-OperationalStatus <OperationalStatus[]> ] [-ThrottleLimit <Int32> ] [-VirtualDisk <CimInstance> ] [ <CommonParameters>]
Description détaillée
The Get-StorageNode cmdlet gets objects that represent storage nodes and their operational statuses. Use this cmdlet to get storage nodes to pass to the Get-PhysicalDisk cmdlet or the Get-VirtualDisk cmdlet to get the physical or virtual disks connected to storage nodes. Use the current cmdlet with the Get-StoragePool cmdlet to get the storage pools that storage nodes own.
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 |
-Name<String[]>
Specifies an array of names. The cmdlet gets the storage nodes that you specify by name.
Alias |
none |
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 |
-OperationalStatus<OperationalStatus[]>
Specifies an array of OperationStatus objects. The cmdlet gets storage nodes that match the operational statuses that you specify. Les valeurs acceptables pour ce paramètre sont :
-- Dormant
-- Down
-- LowerLayerDown
-- NotPresent
-- Testing
-- Unknown
-- Up
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 |
-PhysicalDisk<CimInstance>
Specifies a physical disk as a CimInstance object. The cmdlet gets the storage nodes that correspond to the disk that you specify. To obtain a physical disk object, use the Get-PhysicalDisk 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 |
-StorageEnclosure<CimInstance>
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 |
-StoragePool<CimInstance>
Specifies a storage pool as a CimInstance object. The cmdlet gets storage node associated with storage pool that you specify. To obtain a storage pool object, 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 |
-StorageSubSystem<CimInstance>
Specifies a storage subsystem as a CimInstance object. The cmdlet gets the storage nodes that belong to the subsystem that you specify. To obtain a storage subsystem object, use the Get-StorageSubSystem 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 unique IDs, as strings. The cmdlet gets the storage nodes that have the IDs that you specify.
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 nodes that correspond to the disk that you specify. To obtain a virtual disk object, use the Get-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.
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
-
This cmdlet outputs an array of objects that represent storage nodes and their operational statuses.
Exemples
Example 1: Get a storage node
This command gets a storage node named StorageNode21.
PS C:\> Get-StorageNode -Name "StorageNode21"
Example 2: Get the operational statuses for all physical disks
This command uses the Get-PhysicalDisk cmdlet to obtain all the physical disks, and then passes them to the current cmdlet by using the pipeline operator. The cmdlet gets the storage nodes and operational statuses for the physical disks.
PS C:\> Get-PhysicalDisk | Get-StorageNode