Skip to content
PowerShell Commands

Get-PhysicalDisk

Get-PhysicalDisk [-CanPool] [-CimSession <CimSession>] [-Description <String>] [-HealthStatus<Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>] [-Model <String>] [-UniqueId <String>][-Usage <Get-PhysicalDisk.PhysicalDiskUsage>] [<CommonParameters>]
Get-PhysicalDisk [-CanPool] [-CimSession <CimSession>] [-Description <String>] [-HealthStatus<Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>] [-Model <String>] [-ObjectId <String>][-Usage <Get-PhysicalDisk.PhysicalDiskUsage>] [<CommonParameters>]
Get-PhysicalDisk [[-FriendlyName] <String>] [[-SerialNumber] <String>] [-CanPool] [-CimSession <CimSession>][-Description <String>] [-HealthStatus <Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>][-Model <String>] [-Usage <Get-PhysicalDisk.PhysicalDiskUsage>] [<CommonParameters>]
Get-PhysicalDisk [-CanPool] [-CimSession <CimSession>] [-Description <String>] [-HealthStatus<Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>] [-Model <String>] [-Usage<Get-PhysicalDisk.PhysicalDiskUsage>] -StorageSubsystem* <CimInstance> [<CommonParameters>]
Get-PhysicalDisk [-CanPool] [-CimSession <CimSession>] [-Description <String>] [-HealthStatus<Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>] [-Model <String>] [-Usage<Get-PhysicalDisk.PhysicalDiskUsage>] -StorageEnclosure* <CimInstance> [<CommonParameters>]
Get-PhysicalDisk [-CanPool] [-CimSession <CimSession>] [-Description <String>] [-HealthStatus<Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>] [-Model <String>] [-PhysicallyConnected][-Usage <Get-PhysicalDisk.PhysicalDiskUsage>] -StorageNode* <CimInstance> [<CommonParameters>]
Get-PhysicalDisk [-CanPool] [-CimSession <CimSession>] [-Description <String>] [-HealthStatus<Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>] [-Model <String>] [-Usage<Get-PhysicalDisk.PhysicalDiskUsage>] -StoragePool* <CimInstance> [<CommonParameters>]
Get-PhysicalDisk [-CanPool] [-CimSession <CimSession>] [-Description <String>] [-HasAllocations <Boolean>][-HealthStatus <Get-PhysicalDisk.PhysicalDiskHealthStatus>] [-Manufacturer <String>] [-Model <String>][-NoRedundancy] [-SelectedForUse <Boolean>] [-Usage <Get-PhysicalDisk.PhysicalDiskUsage>] [-VirtualRangeMax<UInt64>] [-VirtualRangeMin <UInt64>] -VirtualDisk* <CimInstance> [<CommonParameters>]
Get-PhysicalDisk [-CimSession <CimSession>] [<CommonParameters>]

The Get-PhysicalDisk cmdlet gets a list of all PhysicalDisk objects visible across any available Storage Management Providers, or optionally a filtered list of disks.

Parameters

-CanPool [<SwitchParameter>]

Indicates that this cmdlet gets physical disks that are available for use in a storage pool.

-CimSession [<CimSession>]

Runs 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.

-Description [<String>]

Specifies a description. The cmdlet gets the physical disks that contain the description. You can use wildcard characters to enter a description pattern.

-FriendlyName [<String>]

  • Accepts pipeline input ByValue

Gets the physical disk with the specified friendly name. Enter a friendly name, or use wildcard characters to enter a name pattern.

-HasAllocations [<Boolean>]

Indicates 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.

-HealthStatus [<Get-PhysicalDisk.PhysicalDiskHealthStatus>]

Specifies the health status of physical disks to get. The acceptable values for this parameter are:

-- Healthy -- Unhealthy -- Unknown -- Warning

-Manufacturer [<String>]

Specifies a manufacturer. The cmdlet gets the physical disks that match the value. You can use wildcard characters to enter a pattern.

-Model [<String>]

Specifies a model. The cmdlet gets the physical disks that match the value. You can use wildcard characters to enter a pattern.

-NoRedundancy [<SwitchParameter>]

Indicates that this cmdlet gets physical disks that contain the last remaining copy of the data of a virtual disk.

-ObjectId [<String>]

  • Accepts pipeline input ByValue

Specifies the ID of the physical disk to get.

-PhysicallyConnected [<SwitchParameter>]

Indicates that this cmdlet gets physical disks that are physically connected to the specified storage node.

-SelectedForUse [<Boolean>]

Indicates 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.

-SerialNumber [<String>]

  • Accepts pipeline input ByValue

Specifies the serial number of the physical disk to get.

-StorageEnclosure <CimInstance>

  • This value is required
  • Accepts pipeline input ByValue

Specifies a storage enclosure associated with the physical disk that this cmdlet gets. To obtain a StorageEnclosure object, use the Get-StorageEnclosure cmdlet.

-StorageNode <CimInstance>

  • This value is required
  • Accepts pipeline input ByValue

Specifies 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.

-StoragePool <CimInstance>

  • This value is required
  • Accepts pipeline input ByValue

Accepts 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.

-StorageSubsystem <CimInstance>

  • This value is required
  • Accepts pipeline input ByValue

Specifies 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.

-UniqueId [<String>]

  • Accepts pipeline input ByValue

Gets only the physical disks with the specified IDs. Type one or more IDs (separated by commas), or use wildcard characters to enter a pattern.

-Usage [<Get-PhysicalDisk.PhysicalDiskUsage>]

Specifies 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

-VirtualDisk <CimInstance>

  • This value is required
  • Accepts pipeline input ByValue

Accepts 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.

-VirtualRangeMax [<UInt64>]

This parameter is reserved for future use.

-VirtualRangeMin [<UInt64>]

This parameter is reserved for future use.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool
http://msdn.microsoft.com/library/windows/desktop/hh830551.aspx You can use the pipeline operator to pass an MSFT_StoragePool object to the StoragePool parameter. Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageSubsystem http://msdn.microsoft.com/library/windows/desktop/hh830569.aspx You can use the pipeline operator to pass an MSFT_StorageSubsystem object to the StorageSubsystem parameter. Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_VirtualDisk http://msdn.microsoft.com/library/windows/desktop/hh830584.aspx You can use the pipeline operator to pass an MSFT_VirtualDisk object to the VirtualDisk parameter.
Outputs
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_PhysicalDisk
http://msdn.microsoft.com/library/windows/desktop/hh830532.aspx The Get-PhysicalDisk cmdlet returns objects that represent physical disks.
Examples
  1. Getting all physical disks:
    PS 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.

  2. Getting all physical disks eligible for adding to a storage pool:
    PS 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).

This work is licensed under a Creative Commons Attribution 4.0 International. It is attributed to Microsoft Corporation and can be found here.

PowerShell Commands