Share via


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.

  • MSFT_StorageNode[]

    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

Rubriques connexes

Get-PhysicalDisk

Get-StoragePool

Get-StorageSubSystem

Get-VirtualDisk