This topic has not yet been rated - Rate this topic

Get-SpacesPhysicalDisk

Published: February 6, 2013

Updated: February 6, 2013

Applies To: Windows 8, Windows Server 2012

Get-SpacesPhysicalDisk

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

Syntax

Parameter Set: None
Get-SpacesPhysicalDisk [[-OnlyListAvailable]] [[-BusType] <String> ] [[-Throttle] <Int32> ] [ <CommonParameters>]

Parameter Set: ByClusterFriendlyName
Get-SpacesPhysicalDisk [[-OnlyListAvailable]] [[-BusType] <String> ] [-ClusterFriendlyName] <String> [[-Throttle] <Int32> ] [ <CommonParameters>]

Parameter Set: ByComputerList
Get-SpacesPhysicalDisk [[-OnlyListAvailable]] [[-BusType] <String> ] [-ServerToCompare] <String[]> [[-Throttle] <Int32> ] [ <CommonParameters>]

Detailed Description

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

Parameters

-BusType<String>

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

Aliases	none
Required?	false
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ClusterFriendlyName<String>

Aliases	none
Required?	true
Position?	3
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).

Aliases	none
Required?	false
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ServerToCompare<String[]>

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

Aliases	none
Required?	true
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Throttle<Int32>

Aliases	none
Required?	false
Position?	4
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

None

Outputs

The output type is the type of the objects that the cmdlet emits.

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_PhysicalDisk
This cmdlet returns objects that represent physical disks.

Notes

The StorageSpaces module is a downloadable module available for use with Windows Server 2012 and Windows 8. You can download the module from the Script Center.

Examples

Example 1 – Display physical disks

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

PowerShell

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

Example 2 – Display physical disks not in a pool

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

PowerShell

PS C:\> Get-SpacesPhysicalDisk -OnlyListAvailable

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

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

PowerShell

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

Example 4 – Display physical disks common to a failover cluster

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

PowerShell

PS C:\> Get-SpacesPhysicalDisk -ClusterFriendlyName DeepSpaceCluster

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)