< Back

Get-StorageSubsystem

Wed Jan 30, 2019 6:02 pm

NAME Get-StorageSubsystem



SYNOPSIS

Gets one or more StorageSubsystem objects.





SYNTAX

Get-StorageSubsystem [[-FriendlyName] <String[]>] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model

<String[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-ThrottleLimit

<Int32>] [-UniqueId <String[]>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-Name <String[]>]

[-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-StorageFaultDomain

<CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-FileServer <Microsoft.Management.Infrastructure.CimInstance>] [-HealthStatus <HealthStatus[]>]

[-Manufacturer <String[]>] [-Model <String[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-ThrottleLimit

<Int32>] [-Volume <Microsoft.Management.Infrastructure.CimInstance>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-Partition

<Microsoft.Management.Infrastructure.CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-Disk <Microsoft.Management.Infrastructure.CimInstance>] [-HealthStatus <HealthStatus[]>]

[-Manufacturer <String[]>] [-Model <String[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>]

[-OffloadDataTransferSetting <CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-InitiatorId <CimInstance>] [-Manufacturer <String[]>] [-Model

<String[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-TargetPortal

<CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-TargetPort

<CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-MaskingSet <CimInstance>] [-Model

<String[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-ThrottleLimit

<Int32>] [-VirtualDisk <CimInstance>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-StoragePool

<CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-StorageNode

<CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-StorageSubsystem [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model <String[]>] [-StorageProvider

<CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]





DESCRIPTION

The Get-StorageSubsystem cmdlet gets one or more StorageSubsystem objects. If no parameters are specified, then all subsystems on the system will be

returned. If two parameters are specified that conflict with unique values, then no subsystem will be returned; since none match that criteria.





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 subsystems. 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



-FileServer [<Microsoft.Management.Infrastructure.CimInstance>]

Specifies the file server on which to get storage subsystems. To obtain a FileServer object, use the Get-StorageFileServer cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? true(ByValue)

Accept wildcard characters? false



-FriendlyName [<String[]>]

Specifies the friendly name of the storage subsystem to get.



Required? false

Position? 1

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-HealthStatus [<HealthStatus[]>]

Specifies the health status for which this cmdlet gets storage subsystems. The acceptable values for this parameter are: Healthy, Warning, and

Unhealthy.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-InitiatorId [<CimInstance>]

Gets the storage subsystem associated with the specified InitiatorId object. Enter an InitiatorID CIM object. The InitiatorID object is exposed by

the Get-InitiatorId cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-Manufacturer [<String[]>]

Specifies a manufacturer of storage subsystems to get.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-MaskingSet [<CimInstance>]

Gets the StorageSubsystem for the specified MaskingSet object. Enter a MaskingSet CIM object. The MaskingSet object is exposed by the Get-MaskingSet

cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-Model [<String[]>]

Specifies a model for which to get storage subsystems.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Name [<String[]>]

Gets the StorageSubsystem with the specified name.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-OffloadDataTransferSetting [<CimInstance>]

Gets the StorageSubsystem associated with the specified OffloadDataTransferSetting object. The Offload Data Transfer Setting CIM object is exposed

by the Get-OffloadDataTransferSetting cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-Partition [<Microsoft.Management.Infrastructure.CimInstance>]

Specifies a partition associated with a storage subsystem to get. To obtain a Partition object, use the Get-Partition cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? true(ByValue)

Accept wildcard characters? false



-StorageFaultDomain [<CimInstance>]

Specifies a storage fault domain associated with a storage subsystem to get. To obtain a StorageFaultDomain object, use the Get-StorageFaultDomain

cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? true(ByValue)

Accept wildcard characters? false



-StorageNode [<CimInstance>]

Specifies a storage node as a CimInstance object. The cmdlet gets storage subsystems on the node that you specify. To obtain a storage node object,

use the Get-StorageNode cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-StoragePool [<CimInstance>]

Gets the StorageSubsystem associated with the specified StoragePool object. The Storage Pool CIM object is exposed by the Get-StoragePool cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-StorageProvider [<CimInstance>]

Gets the StorageSubsystem associated with the specified StorageProvider object. The Storage Provider CIM object is exposed by the

Get-StorageProvider cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-TargetPort [<CimInstance>]

Gets the StorageSubsystem associated with the specified TargetPort object. The TargetPort CIM object is exposed by the Get-TargetPort cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-TargetPortal [<CimInstance>]

Gets the StorageSubsystem associated with the specified TargetPortal object. The TargetPortal CIM object is exposed by the Get-TargetPortal 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[]>]

Gets the StorageSubsystem with the specified UniqueID value.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-VirtualDisk [<CimInstance>]

Gets the StorageSubsystem associated with the specified VirtualDisk object. The Virtual Disk CIM object is exposed by 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 that is associated the storage subsystem that this cmdlet gets. 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

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_InitiatorId

http://msdn.microsoft.com/library/windo ... 30504.aspx





You can use the pipeline operator to pass an InitiatorID object to the InitiatorID parameter to get the storage subsystem associated with the object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_MaskingSet

http://msdn.microsoft.com/library/windo ... 30509.aspx





You can use the pipeline operator to pass a MaskingSet object to the MaskingSet parameter to get the storage subsystem associated with the object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_OffloadDataTransferSetting

http://msdn.microsoft.com/library/windo ... 30523.aspx





You can use the pipeline operator to pass an OffloadDataTransferSetting object to the OffloadDataTransferSetting parameter to get the storage

subsystem associated with the object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_PhysicalDisk

http://msdn.microsoft.com/library/windo ... 30532.aspx





You can use the pipeline operator to pass a PhysicalDisk object to the PhysicalDisk parameter to get the storage subsystem associated with the

object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageNode

http://msdn.microsoft.com/library/windo ... s.85).aspx





You can use the pipeline operator to pass a StorageNode object to the StorageNode parameter to get the storage subsystem associated with the object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool

http://msdn.microsoft.com/library/windo ... 30551.aspx





You can use the pipeline operator to pass a StoragePool object to the StoragePool parameter to get the storage subsystem associated with the object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageProvider

http://msdn.microsoft.com/library/windo ... 30562.aspx





You can use the pipeline operator to pass a StorageProvider object to the StorageProvider parameter to get the storage subsystem associated with the

object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_TargetPort

http://msdn.microsoft.com/library/windo ... 30582.aspx





You can use the pipeline operator to pass a TargetPort object to the TargetPort parameter to get the storage subsystem associated with the object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_TargetPortal

http://msdn.microsoft.com/library/windo ... 30583.aspx





You can the pipeline operator to pass a TargetPortal object to the TargetPortal parameter to get the storage subsystem associated with the object.



Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_VirtualDisk

http://msdn.microsoft.com/library/windo ... 30584.aspx





You can use the pipeline operator to pass a VirtualDisk object to the VirtualDisk parameter to get the storage subsystem associated with the object.





OUTPUTS

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageSubsystem

http://msdn.microsoft.com/library/windo ... 30569.aspx





This cmdlet outputs an object representing a storage subsystem.





Example 1: Get all storage subsystems



PS C:\\>Get-StorageSubsystem



This example returns a list of all visible StorageSubsystem objects across all accessible StorageProvider objects.





Example 2: Get the Windows Storage subsystem



PS C:\\>Get-StorageSubSystem -Model "Storage Spaces"

FriendlyName HealthStatus OperationalStatus

------------ ------------ -----------------

Storage Spaces on SRV1 Healthy OK



This example returns only the StorageSubsystem object for the Storage Spaces provider.





Example 3: Get all unhealthy storage subsystems



PS C:\\>Get-StorageSubSystem -HealthStatus Unhealthy



This example gets all storage subsystems in an unhealthy state.





Example 4: Get storage subsystems that have SMPs that support ODX



PS C:\\>Get-OffloadDataTransferSetting | Get-StorageSubSystem



This example displays all storage subsystems on storage management providers that support Windows Offloaded Data Transfers (ODX). Storage arrays that

support ODX using the SMI-S protocol are not shown.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=816414

Get-DiskStorageNodeView

Get-Partition

Get-StorageFaultDomain

Get-StorageFileServer

Get-StorageProvider

Get-Volume

Get-StorageNode