Remove-VMDvdDrive

[アーティクル]
11/16/2015

Remove-VMDvdDrive

Deletes a DVD drive from a virtual machine.

構文

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

Parameter Set: VMDvdDrive
Remove-VMDvdDrive [-VMDvdDrive] <DvdDrive[]> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Remove-VMDvdDrive cmdlet deletes a DVD drive from a virtual machine.

パラメーター

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

リモートセッションまたはリモートコンピューターでコマンドレットを実行します。コンピューター名またはセッションオブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカルコンピューター上の現在のセッションです。

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts from which the DVD drive is to be deleted. 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.

Aliases	none
必須/オプション	false
位置	named
既定値	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.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Passthru

Specifies that an object is to be passed through to the pipeline representing the DVD drive to be deleted.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-VMDvdDrive<DvdDrive[]>

Specifies the DVD drive to be deleted.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	true (ByValue)
ワイルドカード文字の受け入れ	false

-ControllerLocation<Int32]>

Specifies the number of the location on the controller at which the DVD drive is to be deleted. If not specified, the number of the first available location on the controller is used.

Aliases	none
必須/オプション	true
位置	3
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-ControllerNumber<Int32]>

Specifies the number of the controller from which the DVD drive is to be deleted. If not specified, the first IDE controller on which the specified ControllerLocation is available is used.

Aliases	none
必須/オプション	true
位置	2
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-VMName<String>

Specifies the name of the virtual machine from which the DVD drive is to be deleted.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

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

使用例

Example 1

Removes the virtual DVD drive at IDE 1,0 on virtual machine TestVM.

PS C:\> Remove-VMDvdDrive -VMName TestVM -ControllerNumber 1 -ControllerLocation 0

Example 2

Removes all virtual DVD drives on IDE controller 1 of virtual machine TestVM.

PS C:\> Get-VMDvdDrive -VMName TestVM -ControllerNumber 1 | Remove-VMDvdDrive

Remove-VMDvdDrive