PowerCLI Reference

Get-PassthroughDevice

Synopsis

This cmdlet retrieves the pass-through devices available on the specified hosts, virtual machines, and templates.

Syntax

Get-PassthroughDevice [-VM <VirtualMachine[]>] [-VMHost <VMHost[]>] [-Template <Template[]>] [[-Type] <PassthroughDeviceType>] [[-Name] <String[]>] [-Id <String[]>] [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online version
Add-PassthroughDevice
Remove-PassthroughDevice

Detailed Description

This cmdlet retrieves the pass-through devices available on the specified hosts, virtual machines, and templates.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameString[]Specifies the names of the pass-through devices you want to retrieve.falsefalse
TypePassthroughDeviceTypeSpecifies the type of the pass-through devices you want to retrieve. The valid values are SCSI and PCI. PCI is supported only on vCenter Server 4.1 and ESX 4.1 and later.falsefalse
IdString[]Specifies the IDs of the pass-through devices you want to retrieve.

Note: When a list of values is specified for the Id parameter, the returned objects would have an ID that matches exactly one of the string values in that list.
falsefalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falsefalse
TemplateTemplate[]Specifies the virtual machine templates for which you want to retrieve the pass-through devices.falsetrue (ByValue)
VMVirtualMachine[]Specifies the virtual machines for which you want to retrieve the pass-through devices.falsetrue (ByValue)
VMHostVMHost[]Specifies the hosts for which you want to retrieve the pass-through devices.falsetrue (ByValue)

Return Type

Zero or more PassthroughDevice objects

Notes

Examples

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

Get-PassthroughDevice -VMHost Host -Type Scsi

Retrieves the SCSI passthrough devices of the Host host.


Copyright © VMware, Inc. All rights reserved.