Edit

Share via

Get-PhysicalExtentAssociation

Module:
Storage Module

Gets the physical disk, storage tier, or virtual disk that is associated with a physical extent.

Syntax

Default (Default) 

Get-PhysicalExtentAssociation
    -InputObject <CimInstance>
    [-CimSession <CimSession>]
    [<CommonParameters>]

Description

The Get-PhysicalExtentAssociation cmdlet gets the physical disk, storage tier, or virtual disk that is associated with a physical extent.

Examples

Example 1: Get a physical extent association for a physical extent

PS C:\>Get-PhysicalExtent -PhysicalDisk (Get-PhysicalDisk -FriendlyName "PhysicalDisk4") | Select-Object -Last 1 | Get-PhysicalExtentAssociation

This command uses Get-PhysicalExtent to get all physical extents on the physical disk named PhysicalDisk4. The command passes them to the Select-Object cmdlet by using the pipeline operator. That common Windows PowerShell cmdlet selects the last physical extent returned. That physical extent is passed to the current cmdlet, which gets its physical extent association.

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.

Parameter properties

Type:CimSession
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Specifies the input object that is used in a pipeline command.

Parameter properties

Type:CimInstance
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

PhysicalExtent

You can pass a PhysicalExtent object to this cmdlet.

Outputs

CimInstance

This cmdlet returns a PhysicalDisk object, if the physical extent is associated with a physical disk.

CimInstance

This cmdlet returns a StorageTier object, if the physical extent is associated with a storage tier.

CimInstance

This cmdlet returns a VirtualDisk object, if the physical extent is associated with a virtual disk.

Notes

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