PowerShell Logo Small

Set-VMDvdDrive



This is the built-in help made by Microsoft for the command 'Set-VMDvdDrive', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Configures a virtual DVD drive.

SYNTAX


Set-VMDvdDrive [-VMName] <String> [[-ControllerNumber] <Int32>] [[-ControllerLocation] <Int32>] [[-Path] <String>] [-AllowUnverifiedPaths] [-ComputerName <String[]>]
[-Passthru] [-ResourcePoolName <String>] [-ToControllerLocation <Int32>] [-ToControllerNumber <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-VMDvdDrive [-VM] <VirtualMachine[]> [[-Path] <String>] [-AllowUnverifiedPaths] [-Passthru] [-ResourcePoolName <String>] [-ToControllerLocation <Int32>]
[-ToControllerNumber <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-VMDvdDrive [-VMDvdDrive] <DvdDrive[]> [[-Path] <String>] [-AllowUnverifiedPaths] [-Passthru] [-ResourcePoolName <String>] [-ToControllerLocation <Int32>]
[-ToControllerNumber <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Set-VMDvdDrive cmdlet configures the controller and location of a virtual DVD drive.



<

RELATED LINKS


Online Version: http://go.microsoft.com/fwlink/?LinkID=306941

REMARKS

<

Examples


Example 1

PS C:\>Set-VMDvdDrive -VMName TestVM -Path .\WinBuild.iso



Configures the virtual DVD drive of virtual machine TestVM to use WinBuild.iso as its media.




Example 2

PS C:\>Set-VMDvdDrive -VMName TestVM -ControllerNumber 1 -ControllerLocation 0 -Path $null



Configures the virtual DVD drive at IDE 1,0 of virtual machine TestVM to use no media. (This ejects any existing media from the virtual DVD drive.)




Example 3

PS C:\>Get-VMDvdDrive -VMName TestVM -ControllerNumber 1 -ControllerLocation 0 | Set-VMDvdDrive -ToControllerLocation 1



Moves virtual DVD drive from IDE 1,0 to IDE 1,1 on virtual machine TestVM.