Repair-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

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

Syntax

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 com falha que está em um host gerenciado pelo VMM (Virtual Machine Manager). Uma máquina virtual pode estar em um dos seguintes tipos de estado com falha:

  • Falha na Criação
  • Falha na Migração
  • Falha na atualização
  • Falha na exclusão

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

  • Repetir. Tenta executar o trabalho com falha novamente.
  • Desfazer. Tente desfazer as alterações feitas na máquina virtual e restaurá-la em um estado íntegro. Por exemplo, se um trabalho Move-SCVirtualMachine falhar, Desfazer tentará mover a máquina virtual de volta para o host anterior.
  • Demitir. Descarta 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 Descartar para atualizar os dados da máquina virtual no banco de dados do VMM. No entanto, usar a opção Descartar pode retornar o objeto para o estado com falha.

Ao executar esse cmdlet, você pode especificar apenas um tipo de ação por 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 ao tentar 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 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 em $VM reiniciando a tarefa de migração com falha anterior.

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 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 reparado e armazena esse objeto na variável $Creds.

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

Parâmetros

-Agent

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Dismiss

Descarta 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, atualizar não resolverá o problema e você deverá corrigir o erro.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força a operação a ser concluída.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MigrateDBOnlyVM

Indica que esse cmdlet usa MigrateDBOnlyVM.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

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

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

-Retry

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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

-Undo

Indica que esse cmdlet cancela a última execução do trabalho na máquina virtual e inverte as alterações que foram feitas. Esse parâmetro só estará disponível se o trabalho mais recente falhar.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

Especifica um objeto de máquina virtual.

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

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

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Saídas

VirtualMachine

Observações

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