Set-CDDrive Command | Vmware PowerCLI Reference

Set-CDDrive

This cmdlet updates a virtual CD drive. If an ISO location is provided, sets the CD to point to the ISO. Changes the StartConnected and Connected flags if StartConnected and/or Connected is set. If NoMedia parameter is set to $true, removes the CD drive's media backing and disconnects it. Note that the Connected parameter can be specified only if the corresponding virtual machine is powered on.

Syntax

Set-CDDrive
-CD < CDDrive[] >
[-Connected < Boolean > ]
[-HostDevice < String > ]
[-IsoPath < String > ]
[-NoMedia ]
[-ProgressAction < ActionPreference > ]
[-StartConnected < Boolean > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
CD CDDrive[] named
  • pipeline
Specifies the virtual CD drive you want to configure.
optional Connected Boolean named
Indicates that the virtual CD drive is connected after its creation. This parameter can be specified only if the corresponding virtual machine is powered on.
optional HostDevice String named
Specifies the path to the CD drive on the host which backs this virtual CD drive. Do not use this parameter when the ISOPath and NoMedia parameters are specified.
optional IsoPath String named
Specifies the datastore path to the ISO (CD image) file that backs the virtual CD drive. Do not use this parameter when the HostDevice and NoMedia parameters are specified.
optional NoMedia SwitchParameter named
Indicates that you want to detach from the CD drive any type of connected media - ISO from datastore or host device. Do not use this parameter when the ISOPath or HostDevice parameters are specified.
optional ProgressAction ActionPreference named
optional StartConnected Boolean named
Indicates that the virtual CD drive starts connected when the virtual machine associated with it powers on.

Output

VMware.VimAutomation.ViCore.Types.V1.VirtualDevice.CDDrive

Examples

Example 1

$cd = New-CDDrive -VM VM -ISOPath "[sof-20666-esx:storage1] ISO\testISO.iso"

Set-CDDrive -CD $cd -NoMedia

Creates a CD drive on the VM virtual machine and attaches testISO.iso, previously uploaded. Then disconnects the ISO.

Related Commands

CDDrive

This cmdlet retrieves virtual CD drives.

This cmdlet creates a new virtual CD drive.

This cmdlet removes virtual CD drives from their locations.

This cmdlet modifies the configuration of a virtual CD drive.