Remove-SCVirtualHardDisk
Quita un objeto de disco duro virtual de una máquina virtual o plantilla, o de la biblioteca VMM.
Syntax
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 enumera 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 No, se cancela la operación.
Este cmdlet devuelve el objeto cuando se ejecuta correctamente (con la propiedad MarkedForDeletion establecida en True) o devuelve un mensaje de error tras un error.
Ejemplos
Ejemplo 1: Quitar 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 $VHDEl 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-SCVirtualHardDiskEl 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 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 en el servidor de biblioteca.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDisk
Especifica un objeto de disco duro virtual.
| Type: | VirtualHardDisk |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Notas
- Requiere un objeto de disco duro virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualHardDisk .