Get-SpacesPhysicalDisk

Reference

Module:: StorageSpaces

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.

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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterFriendlyName

Type:	String
Position:	3
Default value:	None
Required:	True
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
Required:	False
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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Throttle

Type:	Int32
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None

Outputs

CimInstance

This cmdlet returns objects that represent physical disks.