Partilhar via


az pipelines variable

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

Gerencie variáveis de pipeline.

Comandos

Name Description Tipo Status
az pipelines variable create

Adicione uma variável a um pipeline.

Extension disponibilidade geral
az pipelines variable delete

Exclua uma variável do pipeline.

Extension disponibilidade geral
az pipelines variable list

Liste as variáveis em um pipeline.

Extension disponibilidade geral
az pipelines variable update

Atualizar uma variável em um pipeline.

Extension disponibilidade geral

az pipelines variable create

Adicione uma variável a um pipeline.

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

Parâmetros Obrigatórios

--name

Nome da variável.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-override

Indica se o valor pode ser definido no momento da fila.

Propriedade Valor
Valores aceites: false, true
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: 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. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do gasoduto.

--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. Necessário se não configurado como padrão ou captado via git config.

--secret

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

Propriedade Valor
Valores aceites: false, true
--value

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 via entrada padrão. Por exemplo, uma variável chamada MySecret pode ser inserida usando a variável de ambiente AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

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

Exclua uma variável do pipeline.

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

Parâmetros Obrigatórios

--name

Nome da variável a ser excluída.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: 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. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do gasoduto.

--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. Necessário se não configurado como padrão ou captado via git config.

--yes -y

Não solicite 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.

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

Liste as variáveis em um pipeline.

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: 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. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do gasoduto.

--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. Necessário se não configurado como padrão ou captado via git config.

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 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 --organization]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--prompt-value {false, true}]
                             [--secret {false, true}]
                             [--value]

Parâmetros Obrigatórios

--name

Nome da variável.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-override

Indica se o valor pode ser definido no momento da fila.

Propriedade Valor
Valores aceites: false, true
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: 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. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

Id do gasoduto.

--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. Necessário se não configurado como padrão ou captado via git config.

--prompt-value

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

Propriedade Valor
Valores aceites: false, true
--secret

Se o valor da variável for um segredo.

Propriedade Valor
Valores aceites: 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 da variável de ambiente prefixada com AZURE_DEVOPS_EXT_PIPELINE_VAR_ por exemplo, uma variável chamada MySecret pode ser inserida usando a variável de ambiente AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

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