Remove-SCVirtualHardDisk
Quita un objeto de disco duro virtual de una máquina virtual o plantilla, o de la biblioteca VMM.
Sintaxis
Default (Es el valor predeterminado).
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 Forzar ), VMM muestra el contenedor que contiene el disco duro virtual y le pide que confirme que desea quitar el disco duro virtual:
Si la respuesta es 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 la respuesta es No, la operación se cancela.
Este cmdlet devuelve el objeto en caso de éxito (con la propiedad MarkedForDeletion establecida en True) o devuelve un mensaje de error en caso de error.
Ejemplos
Ejemplo 1: Eliminar 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 elimina 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: Quitar 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 de 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 elimina cada objeto de disco duro virtual almacenado en la matriz de $VHD de la máquina virtual y elimina cada archivo correspondiente del sistema de archivos en el servidor de biblioteca.
Parámetros
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Obliga a que el comando se ejecute sin pedir confirmación del usuario.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que este progreso se almacena en la variable denominada por este parámetro.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-VirtualHardDisk
Especifica un objeto de disco duro virtual.
Propiedades del parámetro
| Tipo: | VirtualHardDisk |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Notas
- Requiere un objeto de disco duro virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualHardDisk .