Partilhar via


Repair-SCVirtualMachine

Repara uma máquina virtual em um estado de falha.

Sintaxe

Repair-SCVirtualMachine
      [-VM] <VM>
      [-Dismiss]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Repair-SCVirtualMachine
      [-VM] <VM>
      [-Undo]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Repair-SCVirtualMachine
      [-VM] <VM>
      [-Retry]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Repair-SCVirtualMachine
      [-VM] <VM>
      [-Agent]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Repair-SCVirtualMachine
      [-VM] <VM>
      [-MigrateDBOnlyVM]
      -VMHost <Host>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

O cmdlet Repair-SCVirtualMachine repara uma máquina virtual em um estado de falha que está em um host gerenciado pelo Virtual Machine Manager (VMM). Uma máquina virtual pode estar em um dos seguintes tipos de estado de falha:

  • Falha na criação
  • Falha na migração
  • Falha na atualização
  • Falha na exclusão

Você pode usar esse comando para reparar uma falha da seguinte maneira:

  • Retentar. Tenta executar o trabalho com falha novamente.
  • Desfazer. Tente desfazer todas as alterações feitas na máquina virtual e restaurá-la para um estado íntegro. Por exemplo, se um trabalho de Move-SCVirtualMachine falhar, Desfazer tentará mover a máquina virtual de volta para seu host anterior.
  • Recurso desprovido. Rejeita o trabalho com falha e atualiza a máquina virtual com base em seu estado atual. Se você corrigir manualmente uma falha, poderá usar a opção Dispensar para atualizar os dados da máquina virtual no banco de dados do VMM. No entanto, usar a opção Dispensar pode retornar o objeto ao estado de falha.

Ao executar esse cmdlet, você pode especificar apenas um tipo de ação de cada vez.

Você pode executar esse cmdlet para reparar um agente convidado para uma máquina virtual que faz parte de um serviço usando o parâmetro Agent.

Exemplos

Exemplo 1: Reparar uma tarefa de migração com falha tentando novamente a tarefa de migração

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Repair-SCVirtualMachine -VM $VM -Retry

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e, em seguida, armazena esse objeto na variável $VM. Neste exemplo, você deseja reparar uma ação de movimentação com falha.

O segundo comando repara o objeto de máquina virtual armazenado no $VM reiniciando a tarefa de migração anterior com falha.

Exemplo 2: Reparar ou atualizar o agente convidado do VMM em uma máquina virtual especificada que faz parte de um serviço

PS C:\> $VM = Get-SCVirtualMachine -Name "ServiceVM01"
PS C:\> $Creds = Get-Credential
PS C:\> Repair-SCVirtualMachine -VM $VM -Credential $Creds -Agent

O primeiro comando obtém o objeto de máquina virtual chamado ServiceVM01 e, em seguida, armazena esse objeto na variável $VM. Neste exemplo, a máquina virtual faz parte de um serviço.

O segundo comando obtém um objeto de credencial, que deve ser um administrador local na máquina virtual a ser reparada e, em seguida, armazena esse objeto na variável $Creds.

O terceiro comando repara o agente convidado no objeto de máquina virtual armazenado no $VM.

Parâmetros

-Agent

Indica que esse cmdlet repara ou atualiza o agente convidado do VMM, conforme aplicável.

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

-Dismiss

Ignora o erro em um objeto ou uma notificação de atualização em uma instância de serviço.

Depois que um erro é descartado, o objeto é atualizado. Se o erro reaparecer, a atualização não resolve o problema e você deve corrigir o erro.

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

-Force

Força a operação a terminar.

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

-JobVariable

Especifica o nome de uma variável para o progresso do trabalho.

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

-MigrateDBOnlyVM

Indica que esse cmdlet usa MigrateDBOnlyVM.

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

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
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

-Retry

Indica que esse cmdlet tenta novamente a última tarefa que falhou na máquina virtual em uma tentativa de concluir a tarefa com êxito.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
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

-Undo

Indica que esse cmdlet cancela o último trabalho executado na máquina virtual e reverte todas as alterações feitas. Este parâmetro só estará disponível se o trabalho mais recente falhar.

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

-VM

Especifica um objeto de máquina virtual.

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

-VMHost

Especifica um objeto de host de máquina virtual. O VMM suporta hosts Hyper-V, VMware ESX e Citrix XenServer. Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost.

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

Saídas

VirtualMachine

Notas

  • Esse cmdlet requer um objeto de máquina virtual, que pode ser recuperado usando o cmdlet Get-SCVirtualMachine.