< Back
Get-StorageNode
Post
NAME Get-StorageNode
SYNOPSIS
Gets storage nodes.
SYNTAX
Get-StorageNode [-CimSession <CimSession[]>] [-Name <String[]>] [-OperationalStatus <OperationalStatus[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-StoragePool <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-ThrottleLimit <Int32>] [-UniqueId <String[]>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-PhysicallyConnected] [-StorageEnclosure <CimInstance>]
[-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-StorageSubSystem <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-ThrottleLimit <Int32>] [-VirtualDisk <CimInstance>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-PhysicalDisk <CimInstance>] [-PhysicallyConnected]
[-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageNode [-Disk <Microsoft.Management.Infrastructure.CimInstance>] [<CommonParameters>]
Get-StorageNode [-ObjectId <System.String[]>] [<CommonParameters>]
Get-StorageNode [-Volume <Microsoft.Management.Infrastructure.CimInstance>] [<CommonParameters>]
DESCRIPTION
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.
PARAMETERS
-CimSession [<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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Disk [<Microsoft.Management.Infrastructure.CimInstance>]
Specifies a disk for which this cmdlet gets storage notes. To obtain a Disk object, use the Get-Disk cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-Name [<String[]>]
Specifies an array of names. The cmdlet gets the storage nodes that you specify by name.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ObjectId [<System.String[]>]
Specifies an array of object IDs, as strings.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByPropertyName)
Accept wildcard characters? false
-OperationalStatus [<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
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-PhysicallyConnected [<SwitchParameter>]
Indicates that this cmdlet gets the storage nodes that are physically connected to a device.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-StorageEnclosure [<CimInstance>]
Specifies a storage enclosure that is associated with the storage nodes to get. To obtain a StorageEnclosure object, use the Get-StorageEnclosure
cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-ThrottleLimit [<Int32>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-UniqueId [<String[]>]
Specifies an array of unique IDs, as strings. The cmdlet gets the storage nodes that have the IDs that you specify.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Volume [<Microsoft.Management.Infrastructure.CimInstance>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
MSFT_StorageNode[]
http://msdn.microsoft.com/library/windo ... s.85).aspx
This cmdlet outputs an array of objects that represent storage nodes and their operational statuses.
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=816409
Get-DiskStorageNodeView
Get-PhysicalDiskStorageNodeView
Get-StorageEnclosureStorageNodeView
Get-StoragePool
Get-StorageSubsystem
Get-VirtualDisk
Get-Volume
SYNOPSIS
Gets storage nodes.
SYNTAX
Get-StorageNode [-CimSession <CimSession[]>] [-Name <String[]>] [-OperationalStatus <OperationalStatus[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-StoragePool <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-ThrottleLimit <Int32>] [-UniqueId <String[]>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-PhysicallyConnected] [-StorageEnclosure <CimInstance>]
[-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-StorageSubSystem <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-ThrottleLimit <Int32>] [-VirtualDisk <CimInstance>]
[<CommonParameters>]
Get-StorageNode [-CimSession <CimSession[]>] [-OperationalStatus <OperationalStatus[]>] [-PhysicalDisk <CimInstance>] [-PhysicallyConnected]
[-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageNode [-Disk <Microsoft.Management.Infrastructure.CimInstance>] [<CommonParameters>]
Get-StorageNode [-ObjectId <System.String[]>] [<CommonParameters>]
Get-StorageNode [-Volume <Microsoft.Management.Infrastructure.CimInstance>] [<CommonParameters>]
DESCRIPTION
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.
PARAMETERS
-CimSession [<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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Disk [<Microsoft.Management.Infrastructure.CimInstance>]
Specifies a disk for which this cmdlet gets storage notes. To obtain a Disk object, use the Get-Disk cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-Name [<String[]>]
Specifies an array of names. The cmdlet gets the storage nodes that you specify by name.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ObjectId [<System.String[]>]
Specifies an array of object IDs, as strings.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByPropertyName)
Accept wildcard characters? false
-OperationalStatus [<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
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-PhysicallyConnected [<SwitchParameter>]
Indicates that this cmdlet gets the storage nodes that are physically connected to a device.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-StorageEnclosure [<CimInstance>]
Specifies a storage enclosure that is associated with the storage nodes to get. To obtain a StorageEnclosure object, use the Get-StorageEnclosure
cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-ThrottleLimit [<Int32>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-UniqueId [<String[]>]
Specifies an array of unique IDs, as strings. The cmdlet gets the storage nodes that have the IDs that you specify.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? 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.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Volume [<Microsoft.Management.Infrastructure.CimInstance>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
MSFT_StorageNode[]
http://msdn.microsoft.com/library/windo ... s.85).aspx
This cmdlet outputs an array of objects that represent storage nodes and their operational statuses.
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=816409
Get-DiskStorageNodeView
Get-PhysicalDiskStorageNodeView
Get-StorageEnclosureStorageNodeView
Get-StoragePool
Get-StorageSubsystem
Get-VirtualDisk
Get-Volume