Compartilhar via

az connectedmachine run-command

  • Versão Prévia
  • Referência

Observação

Essa referência faz parte da extensão connectedmachine para a CLI do Azure (versão 2.57.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az connectedmachine run-command . Saiba mais sobre extensões.

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

Gerencie comandos de execução em um servidor habilitado para Azure Arc.

Comandos

Nome Description Tipo Status
az connectedmachine run-command create

Crie um comando de execução.

 Extensão Visualizar
az connectedmachine run-command delete

Exclua um comando de execução.

 Extensão Visualizar
az connectedmachine run-command list

Obtenha todos os comandos de execução de um computador que não seja do Azure.

 Extensão Visualizar
az connectedmachine run-command show

Obtenha um comando de execução.

 Extensão Visualizar
az connectedmachine run-command update

Atualize um comando de execução.

 Extensão Visualizar
az connectedmachine run-command wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Extensão Visualizar

az connectedmachine run-command create

Versão Prévia

O grupo de comandos 'az connectedmachine run-command' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um comando de execução.

az connectedmachine run-command create --machine-name
                                       --name
                                       --resource-group
                                       [--async-execution {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--command-id]
                                       [--error-blob-id]
                                       [--error-blob-uri]
                                       [--location]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--output-blob-id]
                                       [--output-blob-uri]
                                       [--parameters]
                                       [--protected-parameters]
                                       [--run-as-password]
                                       [--run-as-user]
                                       [--script]
                                       [--script-uri]
                                       [--script-uri-id]
                                       [--tags]
                                       [--timeout-in-seconds]

Exemplos

Exemplo de comando para criação de comando de execução

az connectedmachine run-command create --resource-group myResourceGroup --location "WestUS" --async false --parameters "[{"name":"param1","value":"value1"}]" --password "<runAsPassword>" --user "user1" --script "Write-Host Hello World!" --timeout 3600 --name myRunCommand --machine-name myMachine --subscription mySubscription
az connectedmachine run-command create --resource-group myResourceGroup --location "WestUS" --script "Write-Host Hello World!" --name myRunCommand --machine-name myMachine --output-uri "outputuri" --subscription mySubscription

Parâmetros Exigidos

--machine-name

O nome da máquina híbrida.

--name --run-command-name -n

O nome do comando run.

--resource-group -g

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

Parâmetros Opcionais

--async-execution

Opcional. Se definido como true, o provisionamento será concluído assim que o script for iniciado e não aguardará a conclusão do script.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
Valor padrão: False
--command-id

Especifica o commandId do script interno predefinido.

--error-blob-id --error-blob-managed-identity

Identidade gerenciada atribuída pelo usuário que tem acesso ao blob de armazenamento errorBlobUri. Use um objeto vazio no caso de identidade atribuída pelo sistema. Verifique se a identidade gerenciada recebeu acesso ao contêiner do blob com a atribuição de função 'Colaborador de Dados do Blob de Armazenamento'. No caso de identidade atribuída pelo usuário, certifique-se de adicioná-la à identidade da VM. Para obter mais informações sobre identidade gerenciada e Executar Comando, consulte https://aka.ms/ManagedIdentity e Suporte a sintaxe https://aka.ms/RunCommandManaged abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--error-blob-uri

Especifica o blob de armazenamento do Azure em que o fluxo de erros de script será carregado. Use um URI SAS com acesso de leitura, acréscimo, criação, gravação OU use a identidade gerenciada para fornecer acesso à VM ao blob. Consulte o parâmetro errorBlobManagedIdentity.

--location -l

A localização geográfica onde o recurso reside Quando não especificado, o local do grupo de recursos será usado.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--output-blob-id --output-blob-managed-identity

Identidade gerenciada atribuída pelo usuário que tem acesso ao blob de armazenamento outputBlobUri. Use um objeto vazio no caso de identidade atribuída pelo sistema. Verifique se a identidade gerenciada recebeu acesso ao contêiner do blob com a atribuição de função 'Colaborador de Dados do Blob de Armazenamento'. No caso de identidade atribuída pelo usuário, certifique-se de adicioná-la à identidade da VM. Para obter mais informações sobre identidade gerenciada e Executar Comando, consulte https://aka.ms/ManagedIdentity e Suporte a sintaxe https://aka.ms/RunCommandManaged abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--output-blob-uri

Especifica o blob de armazenamento do Azure em que o fluxo de saída do script será carregado. Use um URI SAS com acesso de leitura, acréscimo, criação, gravação OU use a identidade gerenciada para fornecer acesso à VM ao blob. Consulte o parâmetro outputBlobManagedIdentity.

--parameters

Os parâmetros usados pelo script. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--protected-parameters

Os parâmetros usados pelo script. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--run-as-password

Especifica a senha da conta de usuário no computador ao executar o comando de execução.

--run-as-user

Especifica a conta de usuário no computador ao executar o comando de execução.

--script

Especifica o conteúdo do script a ser executado na máquina.

--script-uri

Especifica o local de download do script. Pode ser o URI SAS de um blob de armazenamento do Azure com acesso de leitura ou URI público.

--script-uri-id --script-uri-managed-identity

Identidade gerenciada atribuída pelo usuário que tem acesso a scriptUri no caso de blob de armazenamento do Azure. Use um objeto vazio no caso de identidade atribuída pelo sistema. Verifique se o blob de armazenamento do Azure existe e se a identidade gerenciada recebeu acesso ao contêiner do blob com a atribuição de função 'Leitor de Dados do Blob de Armazenamento'. No caso de identidade atribuída pelo usuário, certifique-se de adicioná-la à identidade da VM. Para obter mais informações sobre identidade gerenciada e Executar Comando, consulte https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--tags

Tags de recursos. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--timeout-in-seconds

O tempo limite em segundos para executar o comando de execução.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine run-command delete

Versão Prévia

O grupo de comandos 'az connectedmachine run-command' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Exclua um comando de execução.

az connectedmachine run-command delete [--ids]
                                       [--machine-name]
                                       [--name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--resource-group]
                                       [--subscription]
                                       [--yes]

Exemplos

Exemplo de comando para exclusão de comando de execução

az connectedmachine run-command delete --resource-group myResourceGroup --machine-name myMachine --name myRunCommand

Parâmetros Opcionais

--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 do recurso".

--machine-name

O nome da máquina híbrida.

--name --run-command-name -n

O nome do comando run.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--yes -y

Não solicite confirmação.

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine run-command list

Versão Prévia

O grupo de comandos 'az connectedmachine run-command' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha todos os comandos de execução de um computador que não seja do Azure.

az connectedmachine run-command list --machine-name
                                     --resource-group
                                     [--expand]
                                     [--max-items]
                                     [--next-token]

Exemplos

Exemplo de comando para lista de comandos de execução

az connectedmachine run-command list --resource-group myResourceGroup --machine-name myMachine --subscription mySubscription

Parâmetros Exigidos

--machine-name

O nome da máquina híbrida.

--resource-group -g

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

Parâmetros Opcionais

--expand

A expressão de expansão a ser aplicada na operação.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Esse é o valor do token de uma resposta truncada anteriormente.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine run-command show

Versão Prévia

O grupo de comandos 'az connectedmachine run-command' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha um comando de execução.

az connectedmachine run-command show [--ids]
                                     [--machine-name]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]

Exemplos

Exemplo de comando para run-command show

az connectedmachine run-command show --resource-group myResourceGroup --machine-name myMachine --name myRunCommand

Parâmetros Opcionais

--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 do recurso".

--machine-name

O nome da máquina híbrida.

--name --run-command-name -n

O nome do comando run.

--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine run-command update

Versão Prévia

O grupo de comandos 'az connectedmachine run-command' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize um comando de execução.

az connectedmachine run-command update [--add]
                                       [--async-execution {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--command-id]
                                       [--error-blob-id]
                                       [--error-blob-uri]
                                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--ids]
                                       [--machine-name]
                                       [--name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--output-blob-id]
                                       [--output-blob-uri]
                                       [--parameters]
                                       [--protected-parameters]
                                       [--remove]
                                       [--resource-group]
                                       [--run-as-password]
                                       [--run-as-user]
                                       [--script]
                                       [--script-uri]
                                       [--script-uri-id]
                                       [--set]
                                       [--subscription]
                                       [--tags]
                                       [--timeout-in-seconds]

Exemplos

Comando de exemplo para atualização de comando de execução

az connetcedmachine run-command update --resource-group myResourceGroup --name myRunCommand --machine-name myMachine --subscription mySubscription --tags Tag1=Value1

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um par de caminho e um valor-chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

--async-execution

Opcional. Se definido como true, o provisionamento será concluído assim que o script for iniciado e não aguardará a conclusão do script.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--command-id

Especifica o commandId do script interno predefinido.

--error-blob-id --error-blob-managed-identity

Identidade gerenciada atribuída pelo usuário que tem acesso ao blob de armazenamento errorBlobUri. Use um objeto vazio no caso de identidade atribuída pelo sistema. Verifique se a identidade gerenciada recebeu acesso ao contêiner do blob com a atribuição de função 'Colaborador de Dados do Blob de Armazenamento'. No caso de identidade atribuída pelo usuário, certifique-se de adicioná-la à identidade da VM. Para obter mais informações sobre identidade gerenciada e Executar Comando, consulte https://aka.ms/ManagedIdentity e Suporte a sintaxe https://aka.ms/RunCommandManaged abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--error-blob-uri

Especifica o blob de armazenamento do Azure em que o fluxo de erros de script será carregado. Use um URI SAS com acesso de leitura, acréscimo, criação, gravação OU use a identidade gerenciada para fornecer acesso à VM ao blob. Consulte o parâmetro errorBlobManagedIdentity.

--force-string

Ao usar 'set' ou 'add', preserve os literais de string em vez de tentar converter em JSON.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--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 do recurso".

--machine-name

O nome da máquina híbrida.

--name --run-command-name -n

O nome do comando run.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--output-blob-id --output-blob-managed-identity

Identidade gerenciada atribuída pelo usuário que tem acesso ao blob de armazenamento outputBlobUri. Use um objeto vazio no caso de identidade atribuída pelo sistema. Verifique se a identidade gerenciada recebeu acesso ao contêiner do blob com a atribuição de função 'Colaborador de Dados do Blob de Armazenamento'. No caso de identidade atribuída pelo usuário, certifique-se de adicioná-la à identidade da VM. Para obter mais informações sobre identidade gerenciada e Executar Comando, consulte https://aka.ms/ManagedIdentity e Suporte a sintaxe https://aka.ms/RunCommandManaged abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--output-blob-uri

Especifica o blob de armazenamento do Azure em que o fluxo de saída do script será carregado. Use um URI SAS com acesso de leitura, acréscimo, criação, gravação OU use a identidade gerenciada para fornecer acesso à VM ao blob. Consulte o parâmetro outputBlobManagedIdentity.

--parameters

Os parâmetros usados pelo script. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--protected-parameters

Os parâmetros usados pelo script. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

--resource-group -g

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

--run-as-password

Especifica a senha da conta de usuário no computador ao executar o comando de execução.

--run-as-user

Especifica a conta de usuário no computador ao executar o comando de execução.

--script

Especifica o conteúdo do script a ser executado na máquina.

--script-uri

Especifica o local de download do script. Pode ser o URI SAS de um blob de armazenamento do Azure com acesso de leitura ou URI público.

--script-uri-id --script-uri-managed-identity

Identidade gerenciada atribuída pelo usuário que tem acesso a scriptUri no caso de blob de armazenamento do Azure. Use um objeto vazio no caso de identidade atribuída pelo sistema. Verifique se o blob de armazenamento do Azure existe e se a identidade gerenciada recebeu acesso ao contêiner do blob com a atribuição de função 'Leitor de Dados do Blob de Armazenamento'. No caso de identidade atribuída pelo usuário, certifique-se de adicioná-la à identidade da VM. Para obter mais informações sobre identidade gerenciada e Executar Comando, consulte https://aka.ms/ManagedIdentity e https://aka.ms/RunCommandManaged. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

--subscription

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

--tags

Tags de recursos. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--timeout-in-seconds

O tempo limite em segundos para executar o comando de execução.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az connectedmachine run-command wait

Versão Prévia

O grupo de comandos 'az connectedmachine run-command' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az connectedmachine run-command wait [--created]
                                     [--custom]
                                     [--deleted]
                                     [--exists]
                                     [--ids]
                                     [--interval]
                                     [--machine-name]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]
                                     [--timeout]
                                     [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--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 do recurso".

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--machine-name

O nome da máquina híbrida.

--name --run-command-name -n

O nome do comando run.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.