Skip to main content This browser is no longer supported. Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support. Get-PhysicalDisk
Gets a list of all PhysicalDisk objects visible across any available Storage Management Providers, or optionally a filtered list. In this articleSyntaxGet-PhysicalDisk
[-UniqueId <String>]
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
[-ObjectId <String>]
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
[[-FriendlyName] <String>]
[[-SerialNumber] <String>]
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
-InputObject <CimInstance>
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
-StorageSubsystem <CimInstance>
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
-StorageEnclosure <CimInstance>
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
-StorageNode <CimInstance>
[-PhysicallyConnected]
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
-StoragePool <CimInstance>
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
Get-PhysicalDisk
-VirtualDisk <CimInstance>
[-VirtualRangeMin <UInt64>]
[-VirtualRangeMax <UInt64>]
[-HasAllocations <Boolean>]
[-SelectedForUse <Boolean>]
[-NoRedundancy]
[-Usage <PhysicalDiskUsage>]
[-Description <String>]
[-Manufacturer <String>]
[-Model <String>]
[-CanPool <Boolean>]
[-HealthStatus <PhysicalDiskHealthStatus>]
[-CimSession <CimSession>]
[<CommonParameters>]
DescriptionThe
Get-PhysicalDisk cmdlet gets a list of all PhysicalDisk objects visible across any available Storage Management Providers, or optionally a filtered list of disks. ExamplesExample 1: Getting all physical disksPS C:\> Get-PhysicalDisk
FriendlyName CanPool OperationalStatus HealthStatus Usage Size
------------ -------- ----------------- ------------ ----- ----
PhysicalDisk4 False OK Healthy Data Store 25 GB
This example returns an array of all PhysicalDisk objects present in the computer. A storage management provider is required to manage physical disks. Example 2: Getting all physical disks eligible for adding to a storage poolPS C:\>Get-PhysicalDisk -CanPool $True
This example returns an array of PhysicalDisk objects that are available for adding to a storage pool (they are in a primordial pool). Parameters-CanPoolGets physical disks that are available for use in a storage pool.
| Type:
| Boolean
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-CimSessionRuns 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.
| Type:
| CimSession
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-DescriptionGets the physical disks that contain the specified description. Enter a description or use wildcard characters to enter a description pattern.
| Type:
| String
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-FriendlyNameGets the physical disk with the specified friendly name. Enter a friendly name or use wildcard characters to enter a name pattern.
| Type:
| String
| | Position:
| 0
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-HasAllocationsIndicates whether the cmdlet gets a list of physical disks that host the extents of the virtual disk that you specify by using the VirtualDisk parameter.
| Type:
| Boolean
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-HealthStatusSpecifies the health status of physical disks. The acceptable values for this parameter are: - Healthy
- Unhealthy
- Unknown
- Warning
| Type:
| PhysicalDiskHealthStatus
| | Accepted values:
| Healthy, Warning, Unhealthy, Unknown
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
Specifies the input object that is used in a pipeline command.
| Type:
| CimInstance
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-ManufacturerGets the physical disks with the specified manufacturer. Enter a manufacturer string or use wildcard characters to enter a pattern.
| Type:
| String
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-ModelGets the physical disks of the specified model. Enter a model string or use wildcard characters to enter a pattern.
| Type:
| String
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-NoRedundancyIndicates that this cmdlet gets physical disks that contain the last remaining copy of the data of a virtual disk.
| Type:
| SwitchParameter
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-ObjectIdSpecifies the ID of the physical disk to get.
| Type:
| String
| | Aliases:
| PhysicalDiskObjectId
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-PhysicallyConnectedIndicates that this cmdlet gets physical disks that are physically connected to the specified storage node.
| Type:
| SwitchParameter
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-SelectedForUseIndicates whether the cmdlet gets a list of physical disks to host the extents that belong to the virtual disk specified by the VirtualDisk parameter. Specify the physical disks to host the extents of a virtual disk by using the PhysicalDisksToUse parameter of the New-VirtualDisk cmdlet.
| Type:
| Boolean
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-SerialNumberSpecifies the serial number of the physical disk to get.
| Type:
| String
| | Position:
| 1
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-StorageEnclosureSpecifies a storage enclosure associated with the physical disk that this cmdlet gets. To obtain a StorageEnclosure object, use the Get-StorageEnclosure cmdlet.
| Type:
| CimInstance
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-StorageNodeSpecifies a storage node as a CimInstance object. The cmdlet gets the physical disk connected to the node that you specify. To obtain a storage node object, use the Get-StorageNode cmdlet.
| Type:
| CimInstance
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-StoragePoolAccepts a StoragePool object as input and gets the physical disks that belong to the pool. The Storage Pool CIM object is exposed by the Get-StoragePool cmdlet.
| Type:
| CimInstance
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-StorageSubsystemSpecifies a storage subsystem. This cmdlet gets physical disks attached to the storage subsystem that you specify. To obtain a StorageSubsystem object, use the Get-StorageSubSystem cmdlet.
| Type:
| CimInstance
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-UniqueIdGets only the physical disks with the specified IDs. Type one or more IDs (separated by commas), or use wildcard characters to enter a pattern.
| Type:
| String
| | Aliases:
| Id
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-UsageSpecifies an allocation method or usage. This cmdlet gets the physical disks that have the specified allocation method. The acceptable values for this parameter are: - AutoSelect
- HotSpare
- Journal
- ManualSelect
- Retired
- Unknown
| Type:
| PhysicalDiskUsage
| | Accepted values:
| Unknown, AutoSelect, ManualSelect, HotSpare, Retired, Journal
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-VirtualDiskAccepts a VirtualDisk object as input and gets the physical disks used by the virtual disk. The VirtualDisk object is exposed by the Get-VirtualDisk cmdlet.
| Type:
| CimInstance
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| True
| | Accept wildcard characters:
| False
|
-VirtualRangeMaxThis parameter is reserved for future use.
| Type:
| UInt64
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
-VirtualRangeMinThis parameter is reserved for future use.
| Type:
| UInt64
| | Position:
| Named
| | Default value:
| None
| | Accept pipeline input:
| False
| | Accept wildcard characters:
| False
|
InputsCimInstance You can use the pipeline operator to pass an MSFT_StoragePool object to the StoragePool parameter. CimInstance You can use the pipeline operator to pass an MSFT_StorageSubsystem object to the StorageSubsystem parameter. CimInstance You can use the pipeline operator to pass an MSFT_VirtualDisk object to the VirtualDisk parameter. OutputsCimInstance The Get-PhysicalDisk cmdlet returns objects that represent physical disks. Notes- When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).
- Add-PhysicalDisk
- Get-StorageEnclosure
- Get-StoragePool
- Get-StorageSubSystem
- New-StoragePool
- Remove-PhysicalDisk
- Reset-PhysicalDisk
- Set-PhysicalDisk
- New-VirtualDisk
- Get-StorageNode
FeedbackSubmit and
view feedback for
What type of storage layout does storage space support?
Storage Spaces provides three storage layouts (also known as resiliency types): Mirror. Writes data in a stripe across multiple disks while also writing one or two extra copies of the data.
When you look over an iSCSI configuration What will you see?
15 . When looking over an iSCSI configuration , you see the string iqn.
What are the three primary use scenarios supported by storage replica?
Storage Replica comes in three main configurations: stretch cluster, cluster-to-cluster, and server-to-server.
Which of the following refers to the number of physical disks?
The span length value refers to the number of physical disk drives included in each span.
| 
