Add-PassthroughDevice Command | Vmware PowerCLI Reference

Add-PassthroughDevice

This cmdlet attaches pass-through devices to the specified virtual machine. Note that the value of the ControllerKey property of the returned device might not be up to date, if a new SCSI controller creation process is running in the background.

Syntax

Add-PassthroughDevice
[ -PassthroughDevice ] < PassThroughDevice[] >
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
PassthroughDevice PassThroughDevice[] 1
  • pipeline
Specifies the passthrough devices you want to add to the virtual machine.
required
VM VirtualMachine[] named
  • pipeline
  • wildcards
Specifies the virtual machine to which you want to attach the passthrough devices.
optional Server VIServer[] named
  • wildcards
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.

Output

VMware.VimAutomation.ViCore.Types.V1.VirtualDevice.PassThroughDevice

Examples

Example 1

$scsiDeviceList = Get-PassthroughDevice -VMHost Host -Type Scsi

Add-PassthroughDevice -VM $vm -PassthroughDevice $scsiDeviceList[0]

Adds the first SCSI passthrough device of the Host host to the $vm virtual machine.

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.