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.

Sintaxe

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 Forçar), 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 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 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 a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 ser executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Tipo:VirtualHardDisk
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Observações

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