Partilhar via


az repos policy build

Nota

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 repos policy build . Saiba mais sobre extensões.

Gerencie a política de compilação.

Comandos

Name Description Tipo Estado
az repos policy build create

Crie uma política de compilação.

Extensão GA
az repos policy build update

Atualizar a política de compilação.

Extensão GA

az repos policy build create

Crie uma política de compilação.

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]

Parâmetros Obrigatórios

--blocking

Se a política deve ser de bloqueio ou não.

valores aceites: false, true
--branch

Ramo no qual esta política deve ser aplicada. Por exemplo: mestre.

--build-definition-id

ID da definição de compilação.

--display-name

Nome de exibição para esta política de compilação para identificar a política. Por exemplo: 'Política de fila manual'.

--enabled

Se a política está habilitada ou não.

valores aceites: false, true
--manual-queue-only

Se deve permitir apenas fila manual de compilações.

valores aceites: false, true
--queue-on-source-update-only

Somente fila na atualização de origem.

valores aceites: false, true
--repository-id

Id do repositório no qual aplicar a política.

--valid-duration

Duração da validade da apólice (em minutos).

Parâmetros Opcionais

--branch-match-type

Determina como o argumento branch é usado para aplicar uma política. Se o valor for 'exato', a política será aplicada em uma ramificação que tenha uma correspondência exata no argumento --branch. Se value for 'prefixo', a política será aplicada em todas as pastas de ramificação que correspondem ao prefixo fornecido pelo argumento --branch.

valores aceites: exact, prefix
valor predefinido: exact
--detect

Detete automaticamente a organização.

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. Obrigatório se não estiver configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--path-filter

Caminho(s) de filtro no qual a política é aplicada. Suporta caminhos absolutos, curingas e vários caminhos separados por ';'. Exemplo: /WebApp/Models/Data.cs, /WebApp/* ou *.cs,/WebApp/Models/Data.cs; ClientApp/Modelos/Dados.cs.

--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 captado via git config.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az repos policy build update

Atualizar a política de compilação.

az repos policy build update --id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

Parâmetros Obrigatórios

--id --policy-id

ID da política.

Parâmetros Opcionais

--blocking

Se a política deve ser de bloqueio ou não.

valores aceites: false, true
--branch

Ramo no qual esta política deve ser aplicada. Por exemplo: mestre.

--branch-match-type

Determina como o argumento branch é usado para aplicar uma política. Se o valor for 'exato', a política será aplicada em uma ramificação que tenha uma correspondência exata no argumento --branch. Se value for 'prefixo', a política será aplicada em todas as pastas de ramificação que correspondem ao prefixo fornecido pelo argumento --branch.

valores aceites: exact, prefix
--build-definition-id

ID da definição de compilação.

--detect

Detete automaticamente a organização.

valores aceites: false, true
--display-name

Nome de exibição para esta política de compilação para identificar a política. Por exemplo: 'Política de fila manual'.

--enabled

Se a política está habilitada ou não.

valores aceites: false, true
--manual-queue-only

Se deve permitir apenas fila manual de compilações.

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. Obrigatório se não estiver configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--path-filter

Caminho(s) de filtro no qual a política é aplicada. Suporta caminhos absolutos, curingas e vários caminhos separados por ';'. Exemplo: /WebApp/Models/Data.cs, /WebApp/* ou *.cs,/WebApp/Models/Data.cs; ClientApp/Modelos/Dados.cs.

--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 captado via git config.

--queue-on-source-update-only

Somente fila na atualização de origem.

valores aceites: false, true
--repository-id

Id do repositório no qual aplicar a política.

--valid-duration

Duração da validade da apólice (em minutos).

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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