Remove-SCVirtualHardDisk

Quita un objeto de disco duro virtual de una máquina virtual o plantilla, o de la biblioteca VMM.

Sintaxis

Remove-SCVirtualHardDisk
      [-VirtualHardDisk] <VirtualHardDisk>
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-SCVirtualHardDisk quita un objeto de disco duro virtual de una máquina virtual o plantilla, o de la biblioteca de Virtual Machine Manager (VMM). Remove-VirtualHardDisk también elimina el archivo de disco duro virtual correspondiente (un archivo .vhd basado en Windows, un archivo .vhd basado en Citrix XenServer o un archivo .vmdk basado en VMware) del servidor de biblioteca.

Si el disco duro virtual está conectado a una unidad de disco virtual en una máquina virtual o plantilla (y si no usa el parámetro Force), VMM muestra el contenedor que contiene el disco duro virtual y le pide que confirme que desea quitar el disco duro virtual:

  • Si responde Sí, VMM quita la asociación entre el disco duro virtual y el contenedor al que está conectado y, a continuación, elimina el objeto de disco duro virtual de VMM.

  • Si responde a No, se cancela la operación.

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 un objeto de disco duro virtual de la biblioteca

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD

El primer comando obtiene el objeto de disco duro virtual denominado VHD01.vhd almacenado en LibraryServer01 y almacena el objeto devuelto en la variable $VHD.

El segundo comando quita el objeto de disco duro virtual almacenado en $VHD de la biblioteca y elimina el archivo correspondiente del sistema de archivos en el servidor de biblioteca.

Ejemplo 2: Eliminación de un disco duro virtual de una máquina virtual

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk

El primer comando se conecta a VMMServer01.

El segundo comando obtiene el objeto de máquina virtual denominado VM01, obtiene todos los discos duros virtuales en VM01 cuyo nombre incluye la cadena "DataDisk" y, a continuación, almacena estos objetos de disco duro virtual en una matriz denominada $VHD.

El tercer comando quita cada objeto de disco duro virtual almacenado en la matriz $VHD de la máquina virtual y elimina cada archivo correspondiente del sistema de archivos del 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

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
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:False
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

-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

-VirtualHardDisk

Especifica un objeto de disco duro virtual.

Tipo:VirtualHardDisk
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 disco duro virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualHardDisk.