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.