Get-PassthroughDevice
This cmdlet retrieves the pass-through devices available on the specified hosts, virtual machines, and templates.
Syntax
[
[-Type
]
< PassthroughDeviceType > ]
[-Id
< String[] > ]
[-Name
< String[] > ]
[-Server
< VIServer[] > ]
[-Template
< Template[] > ]
[-VM
< VirtualMachine[] > ]
[-VMHost
< VMHost[] > ]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| optional | Type | PassthroughDeviceType | 1 |
|
Specifies 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. |
| optional | Id | String[] | named |
|
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. |
| optional | Name | String[] | named |
|
Specifies the names of the pass-through devices you want to retrieve. |
| optional | Server | VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null 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. |
| optional | Template | Template[] | named |
|
Specifies the virtual machine templates for which you want to retrieve the pass-through devices. |
| optional | VM | VirtualMachine[] | named |
|
Specifies the virtual machines for which you want to retrieve the pass-through devices. |
| optional | VMHost | VMHost[] | named |
|
Specifies the hosts for which you want to retrieve the pass-through devices. |
Output
VMware.VimAutomation.ViCore.Types.V1.VirtualDevice.PassThroughDeviceExamples
Example 1
Get-PassthroughDevice -VMHost Host -Type Scsi
Retrieves the SCSI passthrough devices of the Host host.
Related Commands
PassthroughDevice
This cmdlet attaches pass-through devices to the specified virtual machine.
This cmdlet retrieves the pass-through devices available on the specified hosts, virtual machines, and templates.
This cmdlet removes the specified pass-through devices.