< Back
Get-PhysicalDisk
Post
NAME Get-PhysicalDisk
SYNOPSIS
Gets a list of all PhysicalDisk objects visible across any available Storage Management Providers, or optionally a filtered list.
SYNTAX
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>]
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.
PARAMETERS
-CanPool [<SwitchParameter>]
Indicates that this cmdlet gets physical disks that are available for use in a storage pool.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-FriendlyName [<String>]
Gets the physical disk with the specified friendly name. Enter a friendly name, or use wildcard characters to enter a name pattern.
Required? false
Position? 1
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-HealthStatus [<Get-PhysicalDisk.PhysicalDiskHealthStatus>]
Specifies the health status of physical disks to get. The acceptable values for this parameter are:
-- Healthy
-- Unhealthy
-- Unknown
-- Warning
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Manufacturer [<String>]
Specifies a manufacturer. The cmdlet gets the physical disks that match the value. You can use wildcard characters to enter a pattern.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Model [<String>]
Specifies a model. The cmdlet gets the physical disks that match the value. You can use wildcard characters to enter a pattern.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-NoRedundancy [<SwitchParameter>]
Indicates that this cmdlet gets physical disks that contain the last remaining copy of the data of a virtual disk.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ObjectId [<String>]
Specifies the ID of the physical disk to get.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-PhysicallyConnected [<SwitchParameter>]
Indicates that this cmdlet gets physical disks that are physically connected to the specified storage node.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SerialNumber [<String>]
Specifies the serial number of the physical disk to get.
Required? false
Position? 2
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-StorageEnclosure <CimInstance>
Specifies a storage enclosure associated with the physical disk that this cmdlet gets. To obtain a StorageEnclosure object, use the
Get-StorageEnclosure cmdlet.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StorageNode <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StoragePool <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StorageSubsystem <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-UniqueId [<String>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-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
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VirtualDisk <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-VirtualRangeMax [<UInt64>]
This parameter is reserved for future use.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VirtualRangeMin [<UInt64>]
This parameter is reserved for future use.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool
http://msdn.microsoft.com/library/windo ... 30551.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/windo ... 30569.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/windo ... 30584.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/windo ... 30532.aspx
The Get-PhysicalDisk cmdlet returns objects that represent physical disks.
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).
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=816394
Add-PhysicalDisk
Get-StorageEnclosureStorageNodeView
Get-StoragePool
Get-StorageSubsystem
New-StoragePool
Remove-PhysicalDisk
Reset-PhysicalDisk
Reset-PhysicalDisk
New-VirtualDisk
Get-StorageNode
SYNOPSIS
Gets a list of all PhysicalDisk objects visible across any available Storage Management Providers, or optionally a filtered list.
SYNTAX
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>]
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.
PARAMETERS
-CanPool [<SwitchParameter>]
Indicates that this cmdlet gets physical disks that are available for use in a storage pool.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-FriendlyName [<String>]
Gets the physical disk with the specified friendly name. Enter a friendly name, or use wildcard characters to enter a name pattern.
Required? false
Position? 1
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-HealthStatus [<Get-PhysicalDisk.PhysicalDiskHealthStatus>]
Specifies the health status of physical disks to get. The acceptable values for this parameter are:
-- Healthy
-- Unhealthy
-- Unknown
-- Warning
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Manufacturer [<String>]
Specifies a manufacturer. The cmdlet gets the physical disks that match the value. You can use wildcard characters to enter a pattern.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Model [<String>]
Specifies a model. The cmdlet gets the physical disks that match the value. You can use wildcard characters to enter a pattern.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-NoRedundancy [<SwitchParameter>]
Indicates that this cmdlet gets physical disks that contain the last remaining copy of the data of a virtual disk.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ObjectId [<String>]
Specifies the ID of the physical disk to get.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-PhysicallyConnected [<SwitchParameter>]
Indicates that this cmdlet gets physical disks that are physically connected to the specified storage node.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-SerialNumber [<String>]
Specifies the serial number of the physical disk to get.
Required? false
Position? 2
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-StorageEnclosure <CimInstance>
Specifies a storage enclosure associated with the physical disk that this cmdlet gets. To obtain a StorageEnclosure object, use the
Get-StorageEnclosure cmdlet.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StorageNode <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StoragePool <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StorageSubsystem <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-UniqueId [<String>]
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.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-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
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VirtualDisk <CimInstance>
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.
Required? true
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-VirtualRangeMax [<UInt64>]
This parameter is reserved for future use.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-VirtualRangeMin [<UInt64>]
This parameter is reserved for future use.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool
http://msdn.microsoft.com/library/windo ... 30551.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/windo ... 30569.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/windo ... 30584.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/windo ... 30532.aspx
The Get-PhysicalDisk cmdlet returns objects that represent physical disks.
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).
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=816394
Add-PhysicalDisk
Get-StorageEnclosureStorageNodeView
Get-StoragePool
Get-StorageSubsystem
New-StoragePool
Remove-PhysicalDisk
Reset-PhysicalDisk
Reset-PhysicalDisk
New-VirtualDisk
Get-StorageNode