Compartilhar via

az pipelines agent

Note

Essa referência faz parte da extensão azure-devops para a CLI do Azure (versão 2.30.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando agente do az pipelines. Saiba mais sobre extensões.

Gerenciar agentes.

Comandos

Nome Description Tipo Status
az pipelines agent list

Obtenha uma lista de agentes em um pool.

 Extension GA
az pipelines agent show

Mostrar detalhes do agente.

 Extension GA

az pipelines agent list

Obtenha uma lista de agentes em um pool.

az pipelines agent list --pool-id
                        [--agent-name]
                        [--demands]
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org --organization]

Parâmetros Exigidos

--pool-id

O pool de agentes que contém os agentes.

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.

--agent-name

Filtrar o nome do agente.

--demands

Filtrar por demandas que os agentes podem satisfazer. Lista separada por vírgulas.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--include-assigned-request

Se deve incluir detalhes sobre o trabalho atual dos agentes.

Propriedade Valor
Valores aceitos: false, true
--include-capabilities

Se os recursos dos agentes devem ser incluídos na resposta.

Propriedade Valor
Valores aceitos: false, true
--include-last-completed-request

Se deve incluir detalhes sobre o trabalho concluído mais recente dos agentes.

Propriedade Valor
Valores aceitos: false, true
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

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 pipelines agent show

Mostrar detalhes do agente.

az pipelines agent show --agent-id --id
                        --pool-id
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org --organization]

Parâmetros Exigidos

--agent-id --id

A ID do agente sobre a qual obter informações.

--pool-id

O pool de agentes que contém o agente.

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.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--include-assigned-request

Se deve incluir detalhes sobre o trabalho atual dos agentes.

Propriedade Valor
Valores aceitos: false, true
--include-capabilities

Se os recursos dos agentes devem ser incluídos na resposta.

Propriedade Valor
Valores aceitos: false, true
--include-last-completed-request

Se deve incluir detalhes sobre o trabalho concluído mais recente dos agentes.

Propriedade Valor
Valores aceitos: false, true
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

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