PowerShell Logo Small

Get-PhysicalDisk



This is the built-in help made by Microsoft for the command 'Get-PhysicalDisk', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets a list of all PhysicalDisk objects visible across any available Storage Management Providers, or optionally a filtered list.

SYNTAX


Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]>] [-CimSession <CimSession[]>] [-Description <String[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model
<String[]>] [-ThrottleLimit <Int32>] [-UniqueId <String[]>] [-Usage <Usage[]>] [<CommonParameters>]
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]>] [-CimSession <CimSession[]>] [-Description <String[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model
<String[]>] [-StoragePool <CimInstance>] [-ThrottleLimit <Int32>] [-Usage <Usage[]>] [<CommonParameters>]
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]>] [-CimSession <CimSession[]>] [-Description <String[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model
<String[]>] [-StorageNode <CimInstance>] [-ThrottleLimit <Int32>] [-Usage <Usage[]>] [<CommonParameters>]
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]>] [-CimSession <CimSession[]>] [-Description <String[]>] [-HasAllocations <Boolean>] [-HealthStatus <HealthStatus[]>]
[-Manufacturer <String[]>] [-Model <String[]>] [-SelectedForUse <Boolean>] [-ThrottleLimit <Int32>] [-Usage <Usage[]>] [-VirtualDisk <CimInstance>] [-VirtualRangeMax
<UInt64>] [-VirtualRangeMin <UInt64>] [<CommonParameters>]
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]>] [-CimSession <CimSession[]>] [-Description <String[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model
<String[]>] [-StorageEnclosure <CimInstance>] [-ThrottleLimit <Int32>] [-Usage <Usage[]>] [<CommonParameters>]
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]>] [-CimSession <CimSession[]>] [-Description <String[]>] [-HealthStatus <HealthStatus[]>] [-Manufacturer <String[]>] [-Model
<String[]>] [-StorageSubSystem <CimInstance>] [-ThrottleLimit <Int32>] [-Usage <Usage[]>] [<CommonParameters>]
Get-PhysicalDisk [[-FriendlyName] <String[]>] [-AsJob] [-CanPool <Boolean[]>] [-CimSession <CimSession[]>] [-Description <String[]>] [-HealthStatus <HealthStatus[]>]
[-Manufacturer <String[]>] [-Model <String[]>] [-ThrottleLimit <Int32>] [-Usage <Usage[]>] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


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.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=298300
Add-PhysicalDisk
Get-StoragePool
New-StoragePool
Remove-PhysicalDisk
Reset-PhysicalDisk
Set-PhysicalDisk
New-VirtualDisk
Get-StorageNode

REMARKS

<

Examples


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




Example 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).