Set-VMDvdDrive

Set-VMDvdDrive

Configures a virtual DVD drive.

语法

Parameter Set: VMName
Set-VMDvdDrive [-VMName] <String> [[-ControllerNumber] <Int32]> ] [[-ControllerLocation] <Int32]> ] [[-Path] <System.String> ] [-AllowUnverifiedPaths] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Passthru] [-ResourcePoolName <System.String> ] [-ToControllerLocation <Nullable [System.Int32]> ] [-ToControllerNumber <Nullable [System.Int32]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Object
Set-VMDvdDrive [-VMDvdDrive] <DvdDrive[]> [[-Path] <System.String> ] [-AllowUnverifiedPaths] [-Passthru] [-ResourcePoolName <System.String> ] [-ToControllerLocation <Nullable [System.Int32]> ] [-ToControllerNumber <Nullable [System.Int32]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

详细说明

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

参数

-AllowUnverifiedPaths

Specifies that no error is to be thrown if the specified path is not verified as accessible by the cluster. This parameter is applicable to clustered virtual machines.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

在远程会话中或远程计算机上运行该 cmdlet。输入计算机名或会话对象,如 New-cimsessionGet-cimsession cmdlet 的输出。默认为本地计算机上的当前会话。

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which the DVD drive is to be configured. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ControllerLocation<Int32]>

Specifies the IDE controller location of the DVD drives to be configured. If not specified, DVD drives in all controller locations are configured.

别名

none

是否必需?

false

在哪里?

3

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ControllerNumber<Int32]>

Specifies the IDE controller of the DVD drives to be configured. If not specified, DVD drives attached to all controllers are configured.

别名

none

是否必需?

false

在哪里?

2

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-Passthru

Specifies that a Microsoft.HyperV.PowerShell.DvdDrive object is to be passed through to the pipeline representing the virtual DVD drive to be configured.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-Path<System.String>

Specifies the path to the ISO file or physical DVD drive that will serve as media for the virtual DVD drive.

别名

none

是否必需?

false

在哪里?

4

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ResourcePoolName<System.String>

Specifies the friendly name of the ISO resource pool to which this DVD drive is to be associated.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ToControllerLocation<Nullable [System.Int32]>

Specifies the controller location to which this virtual DVD drive should be moved.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ToControllerNumber<Nullable [System.Int32]>

Specifies the controller number to which this VMDvdDrive should be moved.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-VMDvdDrive<DvdDrive[]>

Specifies the virtual DVD drive to be configured.

别名

none

是否必需?

true

在哪里?

1

默认值

none

是否接受管道输入?

True (ByValue)

是否接受通配符?

false

-VMName<String>

Specifies the name of the virtual machine on which the DVD drive is to be configured.

别名

none

是否必需?

true

在哪里?

1

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-Confirm

在运行 cmdlet 前提示你进行确认。

是否必需?

false

在哪里?

named

默认值

false

是否接受管道输入?

false

是否接受通配符?

false

-WhatIf

显示在 cmdlet 运行时将发生的情况。该 cmdlet 不运行。

是否必需?

false

在哪里?

named

默认值

false

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持常见的参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 TechNet 上的 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

输入

输入类型是可以传送到 cmdlet 的对象的类型。

输出

输出类型是 cmdlet 发出的对象的类型。

  • None by default; Microsoft.HyperV.PowerShell.DvdDrive if –PassThru is specified.

示例

Example 1

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

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

Example 2

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.)

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

Example 3

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

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