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.
Examples
Example 1: Get a storage node
PS C:\>Get-StorageNode -Name "StorageNode21"
This command gets a storage node named StorageNode21.
Example 2: Get the operational statuses for all physical disks
PS C:\>Get-PhysicalDisk | Get-StorageNode
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.
Parameters
-AsJob
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-CimSession
Runs the cmdlet in a remote session or on a remote computer.
Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet.
The default is the current session on the local computer.
Parameter properties
Type:
CimSession[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Session
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Disk
Specifies a disk for which this cmdlet gets storage notes.
To obtain a Disk object, use the Get-Disk cmdlet.
Parameter properties
Type:
CimInstance
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByDisk
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Name
Specifies an array of names.
The cmdlet gets the storage nodes that you specify by name.
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByName
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-ObjectId
Specifies an array of object IDs, as strings.
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
StorageNodeObjectId
Parameter sets
ByObjectId
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-OperationalStatus
Specifies an array of OperationStatus objects.
The cmdlet gets storage nodes that match the operational statuses that you specify.
The acceptable values for this parameter are:
Dormant
Down
LowerLayerDown
NotPresent
Testing
Unknown
Up
Parameter properties
Type:
OperationalStatus[]
Default value:
None
Accepted values:
Unknown, Up, Down, Joining, Paused
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-PhysicalDisk
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.
Parameter properties
Type:
CimInstance
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByPhysicalDisk
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-PhysicallyConnected
Indicates that this cmdlet gets the storage nodes that are physically connected to a device.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByPhysicalDisk
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
ByStorageEnclosure
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-StorageEnclosure
Specifies a storage enclosure that is associated with the storage nodes to get.
To obtain a StorageEnclosure object, use the Get-StorageEnclosure cmdlet.
Parameter properties
Type:
CimInstance
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByStorageEnclosure
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-StoragePool
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.
Parameter properties
Type:
CimInstance
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByStoragePool
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-StorageSubSystem
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.
Parameter properties
Type:
CimInstance
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByStorageSubSystem
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ThrottleLimit
Specifies the maximum number of concurrent operations that can be established to run the cmdlet.
If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer.
The throttle limit applies only to the current cmdlet, not to the session or to the computer.
Parameter properties
Type:
Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UniqueId
Specifies an array of unique IDs, as strings.
The cmdlet gets the storage nodes that have the IDs that you specify.
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Id
Parameter sets
ByUniqueId
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-VirtualDisk
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.
Parameter properties
Type:
CimInstance
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByVirtualDisk
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Volume
Specifies a volume.
The cmdlet gets the storage nodes that correspond to the volume that you specify.
To obtain a Volume object, use the Get-Volume cmdlet.
Parameter properties
Type:
CimInstance
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ByVolume
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
Outputs
MSFT_StorageNode
This cmdlet outputs an array of objects that represent storage nodes and their operational statuses.
Notes
When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).