New-CDDrive
This cmdlet creates a new virtual CD drive for each of the provided virtual machines. If an ISO location is provided, sets the CD to point to the ISO.
Syntax
-VM
< VirtualMachine >
[-HostDevice
< String > ]
[-IsoPath
< String > ]
[-ProgressAction
< ActionPreference > ]
[-Server
< VIServer[] > ]
[-StartConnected
]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
VM | VirtualMachine | named |
|
Specifies the virtual machine to which the new virtual CD drive belongs. Passing multiple values to this parameter is obsolete. |
| optional | HostDevice | String | named |
|
Specifies the path to the CD drive on the virtual machine host that backs the virtual CD drive. Do not set this parameter if the ISOPath parameter is set. |
| optional | IsoPath | String | named |
|
Specifies the datastore path to the ISO (CD image) file that backs the virtual CD drive. Do not set this parameter if the HostDevice parameter is set. |
| optional | ProgressAction | ActionPreference | named |
|
|
| 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 | StartConnected | SwitchParameter | named |
|
Indicates that the virtual CD drive starts connected when the virtual machine associated with it powers on. |
-ContentLibraryIso
< ContentLibraryItem >
-VM
< VirtualMachine >
[-ProgressAction
< ActionPreference > ]
[-Server
< VIServer[] > ]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
ContentLibraryIso | ContentLibraryItem | named |
|
Specifies the content library item of type ISO that you want to mount on the new CD drive. |
| required
|
VM | VirtualMachine | named |
|
Specifies the virtual machine to which the new virtual CD drive belongs. Passing multiple values to this parameter is obsolete. |
| optional | ProgressAction | ActionPreference | named |
|
|
| 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. |
Output
VMware.VimAutomation.ViCore.Types.V1.VirtualDevice.CDDriveExamples
Example 1
New-CDDrive -VM $vm -ISOPath "Path_to_ISO\test.iso"
Creates a CD drive on the specified virtual machine and attach an ISO image to it.
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.