Compartilhar via


az vm repair

Note

Essa referência faz parte da extensão de reparo de VM para a CLI do Azure (versão 2.0.67 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az vm repair . Saiba mais sobre extensões.

Configure as VMs de reparo com o disco do sistema operacional de origem copiado para resolver problemas.

Quando sua VM não é inicializável, o Reparo de VM permite que os usuários configurem novas VMs de reparo e copiem o disco do sistema operacional da VM de origem e o anexem como um disco de dados. Em seguida, o usuário pode executar seus próprios scripts ou usar os pré-criados para corrigir o disco.

Comandos

Nome Description Tipo Status
az vm repair create

Crie uma nova VM de reparo e anexe o disco do sistema operacional copiado da VM de origem como um disco de dados.

Extension GA
az vm repair list-scripts

Liste os scripts disponíveis. Localizado https://github.com/Azure/repair-script-library.

Extension GA
az vm repair repair-and-restore

Repare e restaure a VM.

Extension Preview
az vm repair repair-button

Script do botão de reparo.

Extension Preview
az vm repair reset-nic

Redefina a pilha de interface de rede no sistema operacional convidado da VM. https://v4.hkg1.meaqua.org/en-us/troubleshoot/azure/virtual-machines/reset-network-interface.

Extension Preview
az vm repair restore

Substitua o disco do sistema operacional da VM de origem pelo disco de dados da VM de reparo.

Extension GA
az vm repair run

Execute scripts verificados do GitHub em uma VM. 'az vm repair list-scripts' para exibir os scripts disponíveis.

Extension GA

az vm repair create

Crie uma nova VM de reparo e anexe o disco do sistema operacional copiado da VM de origem como um disco de dados.

az vm repair create --name
                    --resource-group
                    [--associate-public-ip]
                    [--copy-disk-name]
                    [--disable-trusted-launch]
                    [--distro]
                    [--enable-nested]
                    [--encrypt-recovery-key]
                    [--os-disk-type]
                    [--repair-group-name]
                    [--repair-password]
                    [--repair-username]
                    [--repair-vm-name]
                    [--unlock-encrypted-vm]
                    [--yes]

Exemplos

Criar uma VM de reparo

az vm repair create -g MyResourceGroup -n myVM --verbose

Criar uma VM de reparo e definir a autenticação da VM

az vm repair create -g MyResourceGroup -n myVM --repair-username username --repair-password password!234 --verbose

Criar uma VM de reparo de uma distro específica ou um URN específico também pode ser fornecido

az vm repair create -g MyResourceGroup -n myVM --distro 'rhel7|sles12|ubuntu20|centos6|oracle8|sles15'

Crie uma VM de reparo com um endereço IP privado sem nenhum pop-up solicitando confirmação.

az vm repair create -g MyResourceGroup -n myVM --yes --repair-username <username> --repair-password <password>

Crie uma VM de reparo com um endereço IP público sem nenhuma entrada do usuário.

az vm repair create -g MyResourceGroup -n myVM --associate-public-ip --yes --repair-username <username> --repair-password <password>

Crie uma VM de reparo com o tipo de Segurança Padrão.

az vm repair create -g MyResourceGroup -n myVM --yes --repair-username <username> --repair-password <password> --disable-trusted-launch

Crie uma VM de reparo de uma VM de origem com um disco criptografado. A VM de reparo é criada com o disco de dados não criptografado e acessível.

az vm repair create -g MyResourceGroup -n myVM --yes --repair-username <username> --repair-password <password> --unlock-encrypted-vm --encrypt-recovery-key <key>

Crie uma VM de reparo com um tipo de armazenamento de disco do sistema operacional de StandardSSD_LRS.

az vm repair create -g MyResourceGroup -n myVM --yes --repair-username <username> --repair-password <password> --os-disk-type StandardSSD_LRS

Parâmetros Exigidos

--name -n

O nome da Máquina Virtual. Você pode configurar o padrão usando az configure --defaults vm=<name>o .

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--associate-public-ip

Opção para criar uma VM de reparo com um ip público. Se esse parâmetro não for usado, um ip privado será feito.

Propriedade Valor
Valor padrão: False
--copy-disk-name

Nome da cópia do disco do sistema operacional.

--disable-trusted-launch

Opção para desabilitar o tipo de segurança de Inicialização Confiável na VM de reparo definindo o tipo de segurança como Padrão.

Propriedade Valor
Valor padrão: False
--distro

Opção para criar vm de reparo a partir de uma distribuição Linux específica (rhel7|rhel8|sles12|sles15|ubuntu20|centos7|centos8|oracle7).

Propriedade Valor
Valor padrão: ubuntu
--enable-nested

Habilite o hyperv aninhado.

Propriedade Valor
Valor padrão: False
--encrypt-recovery-key

Opção para desbloquear automaticamente VMs criptografadas usando a senha de recuperação fornecida. O parâmetro '--unlock-encrypted-vm' deve ser usado para usar esse parâmetro.

--os-disk-type

Altere o tipo de armazenamento do disco do sistema operacional do padrão de PremiumSSD_LRS para o valor fornecido.

--repair-group-name

Nome do grupo de recursos novo ou existente que conterá a VM de reparo.

--repair-password

Senha de administrador para a VM de reparo.

--repair-username

Nome de usuário do administrador para reparar a VM.

--repair-vm-name

Nome da VM de reparo.

--unlock-encrypted-vm

Opção para desbloquear automaticamente VMs criptografadas usando a autenticação de assinatura atual.

Propriedade Valor
Valor padrão: False
--yes

Opção para ignorar o prompt para associar ip público no modo Tty.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az vm repair list-scripts

Liste os scripts disponíveis. Localizado https://github.com/Azure/repair-script-library.

az vm repair list-scripts [--preview]

Exemplos

Listar scripts

az vm repair list-scripts --verbose

Listar apenas scripts do Windows.

az vm repair list-scripts --query "[?starts_with(id, 'win')]"

Liste scripts com teste em sua descrição.

az vm repair list-scripts --query "[?contains(description, 'test')]"

Liste o script não verificado do seu fork de https://github.com/Azure/repair-script-library

az vm repair list-scripts --preview "https://github.com/User/repair-script-library/blob/main/map.json"

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--preview

URL da biblioteca de scripts de reparo bifurcado map.json https://github.com/{user}/repair-script-library/blob/master/map.json.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az vm repair repair-and-restore

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Repare e restaure a VM.

az vm repair repair-and-restore [--copy-disk-name]
                                [--ids]
                                [--name]
                                [--repair-group-name]
                                [--repair-password]
                                [--repair-username]
                                [--repair-vm-name]
                                [--resource-group]
                                [--subscription]

Exemplos

Repare e restaure uma VM.

az vm repair repair-and-restore --name vmrepairtest --resource-group MyResourceGroup --verbose

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--copy-disk-name

Nome da cópia do disco do sistema operacional.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da Máquina Virtual. Você pode configurar o padrão usando az configure --defaults vm=<name>o .

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--repair-group-name

Nome do grupo de recursos novo ou existente que conterá a VM de reparo.

--repair-password

Senha de administrador para a VM de reparo.

--repair-username

Nome de usuário do administrador para reparar a VM.

--repair-vm-name

Nome da VM de reparo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az vm repair repair-button

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Script do botão de reparo.

az vm repair repair-button --button-command
                           [--copy-disk-name]
                           [--ids]
                           [--name]
                           [--repair-group-name]
                           [--repair-password]
                           [--repair-username]
                           [--repair-vm-name]
                           [--resource-group]
                           [--subscription]

Exemplos

repair-button.

az vm repair repair-button --name vmrepairtest --resource-group MyResourceGroup --button-command fstab --verbose

Parâmetros Exigidos

--button-command

Button_command para reparar VM.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--copy-disk-name

Nome da cópia do disco do sistema operacional.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da Máquina Virtual. Você pode configurar o padrão usando az configure --defaults vm=<name>o .

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--repair-group-name

Nome do grupo de recursos novo ou existente que conterá a VM de reparo.

--repair-password

Senha de administrador para a VM de reparo.

--repair-username

Nome de usuário do administrador para reparar a VM.

--repair-vm-name

Nome da VM de reparo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az vm repair reset-nic

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Redefina a pilha de interface de rede no sistema operacional convidado da VM. https://v4.hkg1.meaqua.org/en-us/troubleshoot/azure/virtual-machines/reset-network-interface.

az vm repair reset-nic [--ids]
                       [--name]
                       [--resource-group]
                       [--subscription]
                       [--yes]

Exemplos

Redefina a NIC do convidado da VM. Especifique o grupo de recursos e o nome da VM.

az vm repair reset-nic -g MyResourceGroup -n MyVM --verbose

Redefina a NIC do convidado da VM. Especifique a ID da assinatura, o grupo de recursos da VM e o nome.

az vm repair reset-nic -g MyResourceGroup -n MyVM --subscription mySub --verbose

Redefina a NIC convidada da VM e inicie automaticamente a VM se ela não estiver no estado de execução.

az vm repair reset-nic -g MyResourceGroup -n MyVM --yes --verbose

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da Máquina Virtual. Você pode configurar o padrão usando az configure --defaults vm=<name>o .

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes

Não solicite confirmação para iniciar a VM se ela não estiver em execução.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az vm repair restore

Substitua o disco do sistema operacional da VM de origem pelo disco de dados da VM de reparo.

az vm repair restore [--disk-name]
                     [--ids]
                     [--name]
                     [--repair-vm-id]
                     [--resource-group]
                     [--subscription]
                     [--yes]

Exemplos

Restaurar a partir da VM de reparo, o comando procurará automaticamente repair-vm

az vm repair restore -g MyResourceGroup -n MyVM --verbose

Restaurar a partir da VM de reparo, especifique o disco a ser restaurado

az vm repair restore -g MyResourceGroup -n MyVM --disk-name MyDiskCopy --verbose

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--disk-name

Nome do disco de dados fixo. O padrão é o primeiro disco de dados na VM de reparo.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da Máquina Virtual. Você pode configurar o padrão usando az configure --defaults vm=<name>o .

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--repair-vm-id

Repare a ID do recurso da VM.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes

Exclui os recursos de reparo sem confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az vm repair run

Execute scripts verificados do GitHub em uma VM. 'az vm repair list-scripts' para exibir os scripts disponíveis.

az vm repair run [--custom-script-file]
                 [--ids]
                 [--name]
                 [--parameters]
                 [--preview]
                 [--repair-vm-id]
                 [--resource-group]
                 [--run-id]
                 [--run-on-repair]
                 [--subscription]

Exemplos

Execute o script diretamente <run-id> na VM.

az vm repair run -g MyResourceGroup -n MySourceWinVM --run-id win-hello-world --verbose

Execute o script com <run-id> na VM de reparo vinculada.

az vm repair run -g MyResourceGroup -n MySourceWinVM --run-id win-hello-world --run-on-repair --verbose

Execute um script com parâmetros na VM.

az vm repair run -g MyResourceGroup -n MySourceWinVM --run-id win-hello-world --parameters hello=hi world=earth --verbose

Execute um script verificado com alguns parâmetros. No primeiro parâmetro chamado 'key', somente o valor 'test' é enviado para o script. O segundo parâmetro chamado 'initiator', usa o prefixo '++' para enviar toda a cadeia de caracteres 'initiator=selfhelp' a seguir para o script.

az vm repair run -g MyResourceGroup -n MySourceWinVM --run-id linux-alar2 --parameters key=test ++initiator=selfhelp --verbose --debug

Execute um script personalizado local na VM.

az vm repair run -g MyResourceGroup -n MySourceWinVM --custom-script-file ./file.ps1 --verbose

Execute um script não verificado a partir de sua bifurcação de https://github.com/Azure/repair-script-library

az vm repair run -g MyResourceGroup -n MySourceWinVM --preview "https://github.com/User/repair-script-library/blob/main/map.json" --run-id test

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--custom-script-file

Arquivo de script personalizado para ser executado na VM. O script deve ser PowerShell para Windows, Bash para Linux.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da Máquina Virtual. Você pode configurar o padrão usando az configure --defaults vm=<name>o .

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--parameters

Parâmetros separados por espaço no formato de '[name=]value'. Posicional para scripts bash. Para evitar a divisão em =, use o prefixo '++' para enviar a cadeia de caracteres inteira.

--preview

URL da biblioteca de scripts de reparo bifurcado map.json https://github.com/{user}/repair-script-library/blob/master/map.json.

--repair-vm-id

Repare a ID do recurso da VM.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--run-id

ID de execução exclusiva para scripts de execução.

--run-on-repair

O script será executado na VM de reparo vinculada.

Propriedade Valor
Valor padrão: False
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False