Get-EmcAvailablePassthroughDiskCandidate

Gets available pass-through disk candidates to attach or add to a virtual machine for a specified hypervisor.

Syntax

• Get-EmcAvailablePassthroughDiskCandidate [-Hypervisor] <IHypervisor> [-Silent] [<CommonParameters>]

• Get-EmcAvailablePassthroughDiskCandidate [-EsxHostSystem] <IEsxHostSystem> [-Silent] [<CommonParameters>]

Parameters

-Hypervisor <IHypervisor>

Attributes: Required, Position: 1

Specifies the ESI hypervisor host system object, which you can get from the host system by using the Get-EmcHostSystem cmdlet. You can add a hypervisor by using the Get-EmcHostSystemCredential and Connect-EmcSystem cmdlets.

-EsxHostSystem <IESXHostSystem>

Attributes: Required, Position: 1

Specifies the ESI ESX host system object, which you can get by using the Get-EmcESXHost cmdlet.

-Silent <SwitchParameter>

Attributes: Optional, Position: named

Turns off all the informational and verbose messages. However, it still displays errors.

<CommonParameters>

This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.

Examples

-------------- Example 1 --------------

C:\PS>$h = Get-EmcHostSystem *.133

C:\PS>$h.Model

Hyper-V, PowerEdge R710

C:\PS>$hds = $h | Get-EmcAvailablePassthroughDiskCandidate

C:\PS>$hds[0].hostdiskidentifier

\\?\PhysicalDrive3

C:\PS>$hds[1].hostdiskidentifier

\\?\PhysicalDrive4

C:\PS>$h.AvailablePassthroughDiskCandidates[0].hostdiskidentifier

\\?\PhysicalDrive3

C:\PS>$h.AvailablePassthroughDiskCandidates[1].hostdiskidentifier

\\?\PhysicalDrive4

This example gets the available pass-through disk candidates of a hypervisor. You can also get the same information from the hypervisor object.

-------------- Example 2 --------------

C:\PS>$h = Get-EmcESXHost *.99  

C:\PS>$h.Model

    VMware ESXi 5.0.0 build-469512

    C:\PS>$hds = Get-EmcAvailablePassthroughDiskCandidate -EsxHostSystem  $h

    C:\PS>$hds[0].hostdiskidentifier

    0200000000600601607f412e00d0d921654fa6e111565241494420

    C:\PS>$hds[0].CanonicalName

    naa.600601607f412e00d0d921654fa6e111

    C:\PS>$h.AvailablePassthroughDiskCandidates[0].hostdiskidentifier

    0200000000600601607f412e00d0d921654fa6e111565241494420

    C:\PS>$h.AvailablePassthroughDiskCandidates[0].CanonicalName

    naa.600601607f412e00d0d921654fa6e111

This example gets the available passthrough-disk candidates for a VMware ESX host. You can also get the same information from the ESX host object.