Compartilhar via

az pipelines variable

  • Referência

Observação

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 será instalada automaticamente na primeira vez que você executar um comando az pipelines variable . Saiba mais sobre extensões.

Gerenciar variáveis de pipeline.

Comandos

Nome Description Tipo Status
az pipelines variable create

Adicione uma variável a um pipeline.

 Extensão GA
az pipelines variable delete

Exclua uma variável do pipeline.

 Extensão GA
az pipelines variable list

Listar as variáveis em um pipeline.

 Extensão GA
az pipelines variable update

Atualizar uma variável em um pipeline.

 Extensão GA

az pipelines variable create

Adicione uma variável a um pipeline.

az pipelines variable create --name
                             [--allow-override {false, true}]
                             [--detect {false, true}]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--secret {false, true}]
                             [--value]

Parâmetros Exigidos

--name

Nome da variável.

Parâmetros Opcionais

--allow-override

Indica se o valor pode ser definido no tempo de espera.

Valores aceitos: false, true
--detect

Detectar a organização automaticamente.

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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do pipeline.

--pipeline-name

Nome do pipeline. Ignorado se o parâmetro --pipeline-id for fornecido.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

--secret

Indica se o valor da variável é um segredo.

Valores aceitos: false, true
--value

O valor da variável. Para variáveis secretas, se o parâmetro --value não for fornecido, ele será escolhido da variável de ambiente prefixada com AZURE_DEVOPS_EXT_PIPELINE_VAR_ ou o usuário será solicitado a inseri-lo por meio de entrada padrão. por exemplo, uma variável nomeada MySecret pode ser inserida usando a variável de ambiente AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

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 pipelines variable delete

Exclua uma variável do pipeline.

az pipelines variable delete --name
                             [--detect {false, true}]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--yes]

Parâmetros Exigidos

--name

Nome da variável a ser excluída.

Parâmetros Opcionais

--detect

Detectar a organização automaticamente.

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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do pipeline.

--pipeline-name

Nome do pipeline.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

--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 pipelines variable list

Listar as variáveis em um pipeline.

az pipelines variable list [--detect {false, true}]
                           [--org]
                           [--pipeline-id]
                           [--pipeline-name]
                           [--project]

Parâmetros Opcionais

--detect

Detectar a organização automaticamente.

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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do pipeline.

--pipeline-name

Nome do pipeline. Ignorado se o parâmetro --pipeline-id for fornecido.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

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 pipelines variable update

Atualizar uma variável em um pipeline.

az pipelines variable update --name
                             [--allow-override {false, true}]
                             [--detect {false, true}]
                             [--new-name]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--prompt-value {false, true}]
                             [--secret {false, true}]
                             [--value]

Parâmetros Exigidos

--name

Nome da variável.

Parâmetros Opcionais

--allow-override

Indica se o valor pode ser definido no tempo de espera.

Valores aceitos: false, true
--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--new-name

Novo nome da variável.

--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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do pipeline.

--pipeline-name

Nome do pipeline. Ignorado se o parâmetro --pipeline-id for fornecido.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git.

--prompt-value

Defina-o como True para atualizar o valor de uma variável secreta usando a variável de ambiente ou o prompt via entrada padrão.

Valores aceitos: false, true
--secret

Se o valor da variável for um segredo.

Valores aceitos: false, true
--value

Novo valor da variável. Para variáveis secretas, use o parâmetro --prompt-value, para ser solicitado a inseri-lo por meio de entrada padrão. Para consoles não interativos, ele pode ser escolhido a partir de uma variável de ambiente prefixada com AZURE_DEVOPS_EXT_PIPELINE_VAR_ por exemplo, uma variável nomeada MySecret pode ser inserida usando a variável de ambiente AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

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.