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
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
CD | CDDrive[] | named |
|
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 | 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.CDDriveExamples
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.