Get-SpacesPhysicalDisk

Gets all PhysicalDisk objects that can be used with Storage Spaces to form a storage pool.

Syntax

Get-SpacesPhysicalDisk
   [-OnlyListAvailable]
   [[-BusType] <String>]
   [[-Throttle] <Int32>]
Get-SpacesPhysicalDisk
   [-OnlyListAvailable]
   [[-BusType] <String>]
   [-ClusterFriendlyName] <String>
   [[-Throttle] <Int32>]
Get-SpacesPhysicalDisk
   [-OnlyListAvailable]
   [[-BusType] <String>]
   [-ServerToCompare] <String[]>
   [[-Throttle] <Int32>]

Description

The Get-SpacesPhysicalDisk cmdlet gets all PhysicalDisk objects that are available to use with Storage Spaces.

Examples

Example 1 - Display physical disks

PS C:\>Get-SpacesPhysicalDisk
FriendlyName        CanPool             OperationalStatus   HealthStatus        Usage                              Size

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

PhysicalDisk1       False               OK                  Healthy             Auto-Select                   999.25 GB

PhysicalDisk2       False               OK                  Healthy             Auto-Select                   999.25 GB

PhysicalDisk3       False               OK                  Healthy             Auto-Select                   999.25 GB

PhysicalDisk4       True                OK                  Healthy             Auto-Select                     1000 GB

PhysicalDisk5       True                OK                  Healthy             Auto-Select                     1000 GB

PhysicalDisk6       True                OK                  Healthy             Auto-Select                     1000 GB

PhysicalDisk0       False               OK                  Healthy             Auto-Select                       40 GB

This example displays all physical disks available to Storage Spaces on the local computer.

Example 2 - Display physical disks not in a pool

PS C:\>Get-SpacesPhysicalDisk -OnlyListAvailable

This example displays physical disks that are not currently allocated to a storage pool.

Example 3 - Display physical disks common to the local computer and remote servers

PS C:\>Get-SpacesPhysicalDisk -ServerToCompare BigOrange1, BigOrange2

This example displays all common physical disks between the local computer and two servers, BigOrange1 and BigOrange2.

Example 4 - Display physical disks common to a failover cluster

PS C:\>Get-SpacesPhysicalDisk -ClusterFriendlyName DeepSpaceCluster

This example displays all common physical disks among nodes in cluster named DeepSpaceCluster.

Required Parameters

-ClusterFriendlyName
Type:String
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ServerToCompare

Gets all physical disks that are common between the local computer and the specified remote computers.

Type:String[]
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-BusType

Specifies on which bus to obtain PhysicalDisk objects. The acceptable values for this parameter are: iSCSI, SAS, SATA, and USB.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OnlyListAvailable

Specifies that the cmdlet should only get PhysicalDisk objects that are available to add to a storage pool (they do not already belong to a storage pool other than the primordial pool).

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Throttle
Type:Int32
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

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

This cmdlet returns objects that represent physical disks.