Repair-SCVirtualMachine

Módulo:

VirtualMachineManager

Repara uma máquina virtual em um estado com 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 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 para um estado íntegro. Por exemplo, se um trabalho Move-SCVirtualMachine falhar, Desfazer tentará mover a máquina virtual de volta para seu 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 Ignorar para atualizar os dados da máquina virtual no banco de dados do VMM. No entanto, usar a opção Ignorar 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 repetindo 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 reparada e 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
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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 é ignorado, o objeto é atualizado. Se o erro reaparecer, a atualização não resolverá o problema e você deverá corrigir o erro.

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

-Force

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

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

-JobVariable

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

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

-MigrateDBOnlyVM

Indica que esse cmdlet usa MigrateDBOnlyVM.

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

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado 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

-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.

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

-Retry

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
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

-Undo

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

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

-VM

Especifica um objeto de máquina virtual.

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

-VMHost

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

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

Saídas

VirtualMachine

Observações

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

Links Relacionados

• Get-SCUserRole
• Get-SCVirtualMachine
• Move-SCVirtualMachine
• New-SCVirtualMachine
• Read-SCVirtualMachine
• Register-SCVirtualMachine
• Remove-SCVirtualMachine
• Reset-SCVirtualMachine
• Resume-SCVirtualMachine
• Set-SCVirtualMachine
• Start-SCVirtualMachine
• Stop-SCVirtualMachine
• Suspend-SCVirtualMachine