Compartilhar via

Remove-SCVirtualHardDisk

  • Referência
Módulo:
VirtualMachineManager

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 .