Get-PhysicalExtent

  • Reference
Module:
Storage

This cmdlet gets physical allocations for a physical disk, storage tier, or virtual disk. The "extent" (also known as "allocation" or "slab") is the area on a pooled disk containing one fragment of data for storage space.

Syntax

Get-PhysicalExtent
   -VirtualDisk <CimInstance>
   [-CimSession <CimSession>]
   [<CommonParameters>]
Get-PhysicalExtent
   -StorageTier <CimInstance>
   [-CimSession <CimSession>]
   [<CommonParameters>]
Get-PhysicalExtent
   -PhysicalDisk <CimInstance>
   [-CimSession <CimSession>]
   [<CommonParameters>]

Description

The Get-PhysicalExtent cmdlet gets the physical allocations for a physical disk, storage tier, or virtual disk.

Examples

Example 1: Get physical extents on one specific physical disks

PS C:\>Get-PhysicalExtent -PhysicalDisk $(Get-PhysicalDisk)[0]

This command gets physical extents on all physical disks on the computer.

Example 2: Get all physical extents on all physical disks

PS C:\>Get-PhysicalDisk | Get-PhysicalExtent

This command gets all physical extents on all physical disks on the computer.

Example 3: Get extents on a specific disk

PS C:\>Get-PhysicalExtent -PhysicalDisk (Get-PhysicalDisk -FriendlyName "PhysicalDisk4")

This command gets all physical extents on the physical disk named PhysicalDisk4. The command uses Get-PhysicalDisk to obtain PhysicalDisk4.

Example 4: Get all physical extents on a disk (Other Version)

PS C:\>Get-PhysicalDisk -FriendlyName "PhysicalDisk4" | Get-PhysicalExtent

This command gets all physical extents on the physical disk named PhysicalDisk4, using PowerShell pipe. The command uses Get-PhysicalDisk to obtain PhysicalDisk4.

Parameters

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

Type:CimSession
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDisk

Specifies physical disk. To obtain a PhysicalDisk object, use the Get-PhysicalDisk cmdlet.

Type:CimInstance
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageTier

Specifies storage tier. To obtain a StorageTier object, use the Get-StorageTier cmdlet.

Type:CimInstance
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualDisk

Specifies virtual disk. To obtain a VirtualDisk object, use the Get-VirtualDisk cmdlet.

Type:CimInstance
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

CimInstance

You can pass a PhysicalDisk object to this cmdlet.

CimInstance

You can pass a StorageTier object to this cmdlet.

CimInstance

You can pass a VirtualDisk object to this cmdlet.

Outputs

PhysicalExtent

This cmdlet returns the physical allocation that is associated with the input object.

Notes

  • When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).