Compartir a través de

Remove-SCVirtualDVDDrive

  • Referencia
Módulo:
VirtualMachineManager

Quita un objeto de unidad de DVD virtual de VMM.

Sintaxis

Remove-SCVirtualDVDDrive
      [-VirtualDVDDrive] <VirtualDVDDrive>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualDVDDrive
      -SourceBus <Byte>
      -SourceLUN <Byte>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

El cmdlet Remove-SCVirtualDVDDrive quita uno o varios objetos de unidad de DVD virtual de un perfil de hardware, una máquina virtual o una plantilla de máquina virtual usada en un entorno de Virtual Machine Manager (VMM). El cmdlet también elimina cualquier archivo .iso que use la unidad de DVD virtual del sistema de archivos en el servidor de biblioteca.

Este cmdlet devuelve el objeto tras éxito (con la propiedad MarkedForDeletion establecida en True) o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Eliminación de una unidad de DVD virtual específica de una máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive

El primer comando obtiene el objeto de máquina virtual denominado VM01 y almacena el objeto en la variable $VM.

El segundo comando obtiene el objeto de unidad de DVD virtual ubicado en la primera ranura del canal secundario (especificado por -Bus 1 y -LUN 0) en el bus IDE de VM01 y, a continuación, almacena el objeto de unidad de DVD virtual en la variable $DVDDrive.

El último comando quita el objeto de unidad de DVD virtual almacenado en $DVDDrive de VM01 y elimina cualquier archivo .iso que use esta unidad de DVD virtual del sistema de archivos en el servidor de biblioteca.

Ejemplo 2: Eliminación de la tercera unidad de DVD virtual de una máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive

El primer comando obtiene el objeto de máquina virtual denominado VM02 y almacena el objeto en la variable $VM.

El segundo comando obtiene todos los objetos de unidad de DVD virtual conectados a VM02 y almacena cada objeto de unidad de DVD virtual en la matriz de objetos $DVDDrive. En este ejemplo se supone que VM02 tiene tres unidades de DVD virtuales y, por tanto, la matriz contiene tres elementos (contando entre 0 y 2).

El último comando pasa la tercera unidad de DVD virtual (objeto [2]) almacenada en $DVDDrive a la cmdlet Remove-SCVirtualDVDDrive, que quita este objeto de unidad de DVD virtual de VM02 y elimina cualquier archivo .iso usado por esta unidad de DVD virtual del sistema de archivos en el servidor de biblioteca.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SourceBus

Especifica el bus IDE de origen para la unidad.

Tipo:Byte
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SourceLUN

Especifica el número de unidad lógica de origen (LUN) para un objeto de unidad de DVD virtual en un bus IDE.

Tipo:Byte
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VirtualDVDDrive

Especifica un objeto de unidad de DVD virtual.

Tipo:VirtualDVDDrive
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Notas

  • Requiere un objeto de unidad de DVD virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualDVDDrive .