Partilhar 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 Virtual Machine Manager (VMM). 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 conectado 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á conectado e, em seguida, excluirá o objeto de disco rígido virtual do VMM.

  • Se você responder Não, a operação será cancelada.

Este cmdlet retorna o objeto após o êxito (com a propriedade MarkedForDeletion definida como True) ou retorna uma mensagem de erro em caso de 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 no 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.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Tipo:VirtualHardDisk
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Notas

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