Partilhar via

az vm repair

Note

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

 Extension disponibilidade geral
az vm repair list-scripts

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

 Extension disponibilidade geral
az vm repair repair-and-restore

Repare e restaure a VM.

 Extension Preview
az vm repair repair-button

Script de botão de reparo.

 Extension Preview
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

 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 disponibilidade geral
az vm repair run

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

 Extension disponibilidade geral

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

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 tornar-se necessários para que o comando seja executado com êxito.

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

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

Propriedade Valor
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).

Propriedade Valor
Default value: ubuntu
--enable-nested

Habilite o hyperv aninhado.

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

Propriedade Valor
Default value: False
--yes

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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

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 subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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

repair-button.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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

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 subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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

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 subscrição. 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 a confirmação para iniciar a VM se ela não estiver em execução.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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, especificar o disco a restaurar

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 tornar-se necessários para que o comando seja executado com êxito.

--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 que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

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

Reparar ID de 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 subscrição. 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
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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

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 exclusivo para scripts de execução.

--run-on-repair

O script será executado na VM de reparo vinculada.

Propriedade Valor
Default value: False
--subscription

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False