Partilhar via

az vm repair

  • Referência

Nota

Essa referência faz parte da extensão vm-repair 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 SO de origem copiado para resolver problemas.

Quando a 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 pré-construídos para corrigir o disco.

Comandos

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

 Extensão GA
az vm repair list-scripts

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

 Extensão GA
az vm repair repair-and-restore

Repare e restaure a VM.

 Extensão Pré-visualizar
az vm repair repair-button

Script de botão de reparo.

 Extensão Pré-visualizar
az vm repair reset-nic

Redefina a pilha de interface de rede no SO convidado da VM. https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/reset-network-interface

 Extensão Pré-visualizar
az vm repair restore

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

 Extensão GA
az vm repair run

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

 Extensão 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 uma URN específica também pode ser fornecida

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 pedindo 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 qualquer 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 a partir 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 StandardSSD_LRS de armazenamento em disco do sistema operacional.

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

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

Parâmetros Opcionais

--associate-public-ip

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

Default value: False
--copy-disk-name

Nome da cópia do disco do SO.

--disable-trusted-launch

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

Default value: False
--distro

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

Default value: ubuntu
--enable-nested

Habilite o hyperv aninhado.

Default value: 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 em disco do SO do padrão de PremiumSSD_LRS para o valor fornecido.

--repair-group-name

Nome para o 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 assinatura atual auth.

Default value: False
--yes

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

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az vm repair list-scripts

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

az vm repair list-scripts [--preview]

Exemplos

Listar scripts

az vm repair list-scripts --verbose

Liste apenas scripts do Windows.

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

Listar scripts com teste em sua descrição.

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

Listar script não verificado da sua bifurcação 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

--preview

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az vm repair repair-and-restore

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

--copy-disk-name

Nome da cópia do disco do SO.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

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

--repair-group-name

Nome para o 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

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az vm repair repair-button

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Script de 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

botão de reparação.

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

Parâmetros Obrigatórios

--button-command

Button_command para reparar VM.

Parâmetros Opcionais

--copy-disk-name

Nome da cópia do disco do SO.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

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

--repair-group-name

Nome para o 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

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az vm repair reset-nic

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Redefina a pilha de interface de rede no SO convidado da VM. https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/reset-network-interface

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

Exemplos

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

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

Redefina a NIC convidada 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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

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

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes

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

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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, especificar o disco a restaurar

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

Parâmetros Opcionais

--disk-name

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

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

--repair-vm-id

Reparar ID de recurso da VM.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes

Exclui os recursos de reparo sem confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az vm repair run

Execute scripts verificados do GitHub em uma VM. 'az vm repair list-scripts' para visualizar 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 na <run-id> 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', apenas o valor 'test' é enviado para o script. O segundo parâmetro chamado 'initiator', usa o prefixo '++' para enviar toda a seguinte string 'initiator=selfhelp' 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 scripts não verificados a partir da 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

--custom-script-file

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

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

--parameters

Parâmetros separados por espaço no formato '[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 bifurcada map.json https://github.com/{user}/repair-script-library/blob/master/map.json.

--repair-vm-id

Reparar ID de recurso da VM.

--resource-group -g

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

--run-id

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

--run-on-repair

O script será executado na VM de reparo vinculada.

Default value: False
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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