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.
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
This cmdlet returns objects that represent physical disks.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for