Remove-SCVirtualHardDisk
Remove um objeto de disco rígido virtual de uma máquina virtual ou modelo ou da biblioteca do VMM.
Syntax
Remove-SCVirtualHardDisk
[-VirtualHardDisk] <VirtualHardDisk>
[-JobGroup <Guid>]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-SCVirtualHardDisk remove um objeto de disco rígido virtual de uma máquina virtual ou modelo ou da biblioteca do VMM (Virtual Machine Manager). Remove-VirtualHardDisk também exclui o arquivo de disco rígido virtual correspondente (um arquivo .vhd baseado no Windows, um arquivo .vhd baseado em Citrix XenServer ou um arquivo .vmdk baseado em VMware) do servidor de biblioteca.
Se o disco rígido virtual estiver anexado a uma unidade de disco virtual em uma máquina virtual ou modelo (e se você não usar o parâmetro Force ), o VMM listará o contêiner que contém o disco rígido virtual e solicitará que você confirme se deseja remover o disco rígido virtual:
Se você responder Sim, o VMM removerá a associação entre o disco rígido virtual e o contêiner ao qual ele está anexado e, em seguida, excluirá o objeto de disco rígido virtual do VMM.
Se você responder Não, a operação será cancelada.
Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como True) ou retorna uma mensagem de erro após a falha.
Exemplos
Exemplo 1: remover um objeto de disco rígido virtual da 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
O primeiro comando obtém o objeto de disco rígido virtual chamado VHD01.vhd armazenado em LibraryServer01 e armazena o objeto retornado na variável $VHD.
O segundo comando remove o objeto de disco rígido virtual armazenado em $VHD da biblioteca e exclui o arquivo correspondente do sistema de arquivos no servidor de biblioteca.
Exemplo 2: remover um disco rígido virtual de uma 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
O primeiro comando se conecta ao VMMServer01.
O segundo comando obtém o objeto de máquina virtual chamado VM01, obtém todos os discos rígidos virtuais na VM01 cujo nome inclui a cadeia de caracteres "DataDisk" e armazena esses objetos de disco rígido virtual em uma matriz chamada $VHD.
O terceiro comando remove cada objeto de disco rígido virtual armazenado na matriz $VHD da máquina virtual e exclui cada arquivo correspondente do sistema de arquivos no servidor de biblioteca.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualHardDisk
Especifica um objeto de disco rígido virtual.
Type: | VirtualHardDisk |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Observações
- Requer um objeto de disco rígido virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualHardDisk .