Remove-SCVirtualHardDisk

Remove-SCVirtualHardDisk
    [-VirtualHardDisk] <VirtualHardDisk>
    [-JobGroup <Guid>]
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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 no 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 que 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 em caso de êxito (com a propriedade MarkedForDeletion definida como True) ou retorna uma mensagem de erro em caso de falha.

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 no $VHD da biblioteca e exclui o arquivo correspondente do sistema de arquivos no servidor de biblioteca.

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 em VM01 cujo nome inclui a cadeia de caracteres "DataDisk" e, em seguida, 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.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

• Requer um objeto de disco rígido virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualHardDisk .