Get-PhysicalDisk

Get-PhysicalDisk

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

Синтаксис

Parameter Set: ByUniqueId
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]> ] [-CimSession <CimSession[]> ] [-Description <String[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-ThrottleLimit <Int32> ] [-UniqueId <String[]> ] [-Usage <Usage[]> ] [ <CommonParameters>]

Parameter Set: ByName
Get-PhysicalDisk [[-FriendlyName] <String[]> ] [-AsJob] [-CanPool <Boolean[]> ] [-CimSession <CimSession[]> ] [-Description <String[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-ThrottleLimit <Int32> ] [-Usage <Usage[]> ] [ <CommonParameters>]

Parameter Set: ByStorageEnclosure
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]> ] [-CimSession <CimSession[]> ] [-Description <String[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-StorageEnclosure <CimInstance> ] [-ThrottleLimit <Int32> ] [-Usage <Usage[]> ] [ <CommonParameters>]

Parameter Set: ByStorageNode
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]> ] [-CimSession <CimSession[]> ] [-Description <String[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-StorageNode <CimInstance> ] [-ThrottleLimit <Int32> ] [-Usage <Usage[]> ] [ <CommonParameters>]

Parameter Set: ByStoragePool
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]> ] [-CimSession <CimSession[]> ] [-Description <String[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-StoragePool <CimInstance> ] [-ThrottleLimit <Int32> ] [-Usage <Usage[]> ] [ <CommonParameters>]

Parameter Set: ByStorageSubSystem
Get-PhysicalDisk [-AsJob] [-CanPool <Boolean[]> ] [-CimSession <CimSession[]> ] [-Description <String[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-StorageSubSystem <CimInstance> ] [-ThrottleLimit <Int32> ] [-Usage <Usage[]> ] [ <CommonParameters>]

Parameter Set: ByVirtualDisk
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>]

Подробное описание

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.

Параметры

-AsJob

-CanPool<Boolean[]>

Gets physical disks that are available for use in a storage pool.

-CimSession<CimSession[]>

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объекта сеанса, например результат выполнения командлета New-CimSession или Get-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.

-Description<String[]>

Gets the physical disks that contain the specified description. Enter a description, or use wildcard characters to enter a description pattern.

-FriendlyName<String[]>

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<HealthStatus[]>

Gets only physical disks in the specified state. Valid values are Healthy, Unhealthy, Unknown, or Warning.

-Manufacturer<String[]>

Gets the physical disks with the specified manufacturer. Enter a manufacturer string, or use wildcard characters to enter a pattern.

-Model<String[]>

Gets the physical disks of the specified model. Enter a model string or use wildcard characters to enter a pattern.

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

-StorageEnclosure<CimInstance>

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

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

-StorageSubSystem<CimInstance>

Accepts a StorageSubsystem object as input and gets the physical disks attached to the storage subsystem. The Storage Subsystem CIM object is exposed by the Get-StorageSubSystem cmdlet.

-ThrottleLimit<Int32>

Определяет максимальное число одновременных операций, которое можно установить для запуска командлета. Если этот параметр опущен или имеет значение 0, Windows PowerShell® вычисляет оптимальный предел регулирования для командлета на основе числа командлетов CIM, запущенных на компьютере. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.

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

-Usage<Usage[]>

Gets only the physical disks with the specified allocation method (usage) of the disk. Valid values are AutoSelect, HotSpare, Journal, ManualSelect, Retired, and Unknown.

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

-VirtualRangeMax<UInt64>

This parameter is reserved for future use.

-VirtualRangeMin<UInt64>

This parameter is reserved for future use.

<CommonParameters>

Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Входные данные

Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool

  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

  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

  You can use the pipeline operator to pass an MSFT_VirtualDisk object to the VirtualDisk parameter.

Выходные данные

Тип выходных данных — это тип объектов, которые выдает командлет.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_PhysicalDisk

  The Get-PhysicalDisk cmdlet returns objects that represent physical disks.

Примечания

• Объект Microsoft.Management.Infrastructure.CimInstance является классом-оболочкой, который отображает объекты инструментария управления Windows (WMI). После символа решетки (#) задается пространство имен и имя класса базового объекта инструментария управления Windows.

Примеры

Example 1: Getting all physical disks

This example returns an array of all PhysicalDisk objects present in the computer. A storage management provider is required to manage physical disks.

PS C:\> Get-PhysicalDisk

Example 2: Getting all physical disks eligible for adding to a storage pool

This example returns an array of PhysicalDisk objects that are available for adding to a storage pool (they are in a primordial pool).

PS C:\> Get-PhysicalDisk -CanPool $True

Связанные темы

Add-PhysicalDisk

Get-StoragePool

New-StoragePool

Remove-PhysicalDisk

Reset-PhysicalDisk

Set-PhysicalDisk

New-VirtualDisk

Get-StorageNode