Remove-SCVirtualHardDisk
Quita un objeto de disco duro virtual de una máquina virtual o una 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 una 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 la operación correcta (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 $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 rendimiento y optimización de recursos (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 al shell de comandos inmediatamente.
| 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 .