Compartilhar via


az devops

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 az devops . Saiba mais sobre extensões.

Gerencie as operações de nível organizacional do Azure DevOps.

Grupos relacionados az pipelines: Gerenciar Azure Pipelines az boards: Gerenciar Azure Boards az repos: Gerenciar Azure Repos az artifacts: Gerenciar Azure Artifacts.

Comandos

Nome Description Tipo Status
az devops admin

Gerenciar operações de administração.

Extension GA
az devops admin banner

Gerenciar a faixa da organização.

Extension GA
az devops admin banner add

Adicione um novo banner e mostre-o imediatamente.

Extension GA
az devops admin banner list

Listar banners.

Extension GA
az devops admin banner remove

Remova um banner.

Extension GA
az devops admin banner show

Mostrar detalhes de um banner.

Extension GA
az devops admin banner update

Atualize a mensagem, o nível ou a data de expiração de um banner.

Extension GA
az devops configure

Configure a CLI do Azure DevOps ou exiba sua configuração.

Extension GA
az devops extension

Gerenciar extensões.

Extension GA
az devops extension disable

Desabilite uma extensão.

Extension GA
az devops extension enable

Habilitar uma extensão.

Extension GA
az devops extension install

Instale uma extensão.

Extension GA
az devops extension list

Listar extensões instaladas em uma organização.

Extension GA
az devops extension search

Pesquisar extensões do Marketplace.

Extension GA
az devops extension show

Obter detalhes da extensão única.

Extension GA
az devops extension uninstall

Desinstale uma extensão.

Extension GA
az devops invoke

Esse comando invocará a solicitação para qualquer área e recurso do DevOps. Use apenas a saída json, pois a resposta desse comando não foi corrigida. Documentos úteis - https://docs.microsoft.com/en-us/rest/api/azure/devops/.

Extension GA
az devops login

Defina a CREDENCIAL (PAT) a ser usada para uma organização específica.

Extension GA
az devops logout

Desmarque a credencial para toda ou para uma organização específica.

Extension GA
az devops project

Gerenciar projetos de equipe.

Extension GA
az devops project create

Crie um projeto de equipe.

Extension GA
az devops project delete

Excluir projeto de equipe.

Extension GA
az devops project list

Listar projetos de equipe.

Extension GA
az devops project show

Mostrar projeto de equipe.

Extension GA
az devops security

Gerenciar operações relacionadas à segurança.

Extension GA
az devops security group

Gerenciar grupos de segurança.

Extension GA
az devops security group create

Crie um novo grupo do Azure DevOps.

Extension GA
az devops security group delete

Excluir um grupo do Azure DevOps.

Extension GA
az devops security group list

Liste todos os grupos em um projeto ou organização.

Extension GA
az devops security group membership

Gerenciar associações para grupos de segurança.

Extension GA
az devops security group membership add

Adicionar associação.

Extension GA
az devops security group membership list

Listar associações para um grupo ou usuário.

Extension GA
az devops security group membership remove

Remova a associação.

Extension GA
az devops security group show

Mostrar detalhes do grupo.

Extension GA
az devops security group update

Atualizar o nome AND/OR de uma descrição para um grupo do Azure DevOps.

Extension GA
az devops security permission

Gerenciar permissões de segurança.

Extension GA
az devops security permission list

Listar tokens para determinado usuário/grupo e namespace.

Extension GA
az devops security permission namespace

Gerenciar namespaces de segurança.

Extension GA
az devops security permission namespace list

Liste todos os namespaces disponíveis para uma organização.

Extension GA
az devops security permission namespace show

Mostrar detalhes das permissões disponíveis em cada namespace.

Extension GA
az devops security permission reset

Permissão de redefinição para determinados bits de permissão.

Extension GA
az devops security permission reset-all

Desmarque todas as permissões desse token para um usuário/grupo.

Extension GA
az devops security permission show

Mostrar permissões para determinado token, namespace e usuário/grupo.

Extension GA
az devops security permission update

Atribua permissão de permitir ou negar a determinado usuário/grupo.

Extension GA
az devops service-endpoint

Gerenciar pontos de extremidade/conexões de serviço.

Extension GA
az devops service-endpoint azurerm

Gerenciar pontos de extremidade/conexões de serviço do Azure RM.

Extension GA
az devops service-endpoint azurerm create

Crie um ponto de extremidade de serviço do tipo RM do Azure.

Extension GA
az devops service-endpoint create

Crie um ponto de extremidade de serviço usando o arquivo de configuração.

Extension GA
az devops service-endpoint delete

Exclui o ponto de extremidade de serviço.

Extension GA
az devops service-endpoint github

Gerenciar pontos de extremidade/conexões de serviço do GitHub.

Extension GA
az devops service-endpoint github create

Crie um ponto de extremidade de serviço do GitHub.

Extension GA
az devops service-endpoint list

Listar pontos de extremidade de serviço em um projeto.

Extension GA
az devops service-endpoint show

Obtenha os detalhes de um ponto de extremidade de serviço.

Extension GA
az devops service-endpoint update

Atualize um ponto de extremidade de serviço.

Extension GA
az devops team

Gerenciar equipes.

Extension GA
az devops team create

Crie uma equipe.

Extension GA
az devops team delete

Excluir uma equipe.

Extension GA
az devops team list

Liste todas as equipes em um projeto.

Extension GA
az devops team list-member

Listar membros de uma equipe.

Extension GA
az devops team show

Mostrar detalhes da equipe.

Extension GA
az devops team update

Atualize o nome e/ou descrição de uma equipe.

Extension GA
az devops user

Gerenciar usuários.

Extension GA
az devops user add

Adicionar usuário.

Extension GA
az devops user list

Listar usuários em uma organização [exceto para usuários que são adicionados por meio de grupos do AAD].

Extension GA
az devops user remove

Remova o usuário de uma organização.

Extension GA
az devops user show

Mostrar detalhes do usuário.

Extension GA
az devops user update

Atualizar o tipo de licença para um usuário.

Extension GA
az devops wiki

Gerenciar wikis.

Extension GA
az devops wiki create

Criar um wiki.

Extension GA
az devops wiki delete

Excluir um wiki.

Extension GA
az devops wiki list

Liste todos os wikis em um projeto ou organização.

Extension GA
az devops wiki page

Gerenciar páginas wiki.

Extension GA
az devops wiki page create

Adicione uma nova página.

Extension GA
az devops wiki page delete

Excluir uma página.

Extension GA
az devops wiki page show

Obtenha o conteúdo de uma página ou abra uma página.

Extension GA
az devops wiki page update

Editar uma página.

Extension GA
az devops wiki show

Mostrar detalhes de um wiki.

Extension GA

az devops configure

Configure a CLI do Azure DevOps ou exiba sua configuração.

az devops configure [--defaults]
                    [--list]
                    [--use-git-aliases {false, true}]

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.

--defaults -d

Pares 'name=value' separados por espaço para padrões de argumentos comuns, por exemplo, '--defaults project=my-project-name organization=my-org-url arg=value'. Use '' para limpar os padrões, por exemplo, --defaults project='.

--list -l

Lista o conteúdo do arquivo de configuração.

Propriedade Valor
Valor padrão: False
--use-git-aliases

Defina como 'true' para configurar o arquivo de configuração git global do aliases do Git (para habilitar comandos como "lista git pr"). Defina como "false" para remover todos os aliases definidos pela ferramenta.

Propriedade Valor
Valores aceitos: false, true
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 devops invoke

Esse comando invocará a solicitação para qualquer área e recurso do DevOps. Use apenas a saída json, pois a resposta desse comando não foi corrigida. Documentos úteis - https://docs.microsoft.com/en-us/rest/api/azure/devops/.

az devops invoke [--accept-media-type]
                 [--api-version]
                 [--area]
                 [--detect {false, true}]
                 [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                 [--http-method {DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT}]
                 [--in-file]
                 [--media-type]
                 [--org --organization]
                 [--out-file]
                 [--query-parameters]
                 [--resource]
                 [--route-parameters]

Exemplos

Descobrir áreas relacionadas ao 'Wiki'

az devops invoke --query "[?contains(area,'wiki')]"

Obter todos os wikis em um projeto

az devops invoke --area wiki --resource wikis --route-parameters project={Project Name} -o json
az devops invoke --area wiki --resource wikis --route-parameters project=WikiIssue -o json

Adicionar página a um wiki

az devops invoke --area wiki --resource pages --route-parameters project={Project Name}
wikiIdentifier={Wiki Id} --in-file {Full File Path containing text to add to wiki}
--query-parameters path={Page Path In Wiki} --http-method PUT --api-version 5.1-preview -o json
az devops invoke --area wiki --resource pages --route-parameters project=WikiIssue
wikiIdentifier=e479f402-2be8-4953-bb0b-3a0209cbc2d2 --in-file D:/temp/createWikiRequestBody.txt
--encoding 'utf-8' --query-parameters path=sample738 --http-method PUT --api-version 5.1-preview -o json

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.

--accept-media-type

Especifica o tipo de conteúdo da resposta.

Propriedade Valor
Valor padrão: application/json
--api-version

A versão da API a ser direcionada.

Propriedade Valor
Valor padrão: 5.0
--area

A área para localizar o recurso.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--encoding

Codificação do arquivo de entrada. Usado em conjunto com --in-file.

Propriedade Valor
Valor padrão: utf-8
Valores aceitos: ascii, utf-16be, utf-16le, utf-8
--http-method

Especifica o método usado para a solicitação.

Propriedade Valor
Valor padrão: GET
Valores aceitos: DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT
--in-file

Caminho e nome do arquivo para o arquivo que contém o conteúdo da solicitação.

--media-type

Especifica o tipo de conteúdo da solicitação.

Propriedade Valor
Valor padrão: application/json
--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/.

--out-file

Caminho e nome do arquivo para o arquivo para o qual essa função salva o corpo da resposta.

--query-parameters

Especifica a lista de parâmetros de consulta.

--resource

O nome do recurso no qual operar.

--route-parameters

Especifica a lista de parâmetros de rota.

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 devops login

Defina a CREDENCIAL (PAT) a ser usada para uma organização específica.

Consulte https://aka.ms/azure-devops-cli-auth para obter mais informações sobre como fornecer PAT como entrada.

az devops login [--org --organization]

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.

--org --organization

URL da organização do Azure DevOps. 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 devops logout

Desmarque a credencial para toda ou para uma organização específica.

az devops logout [--org --organization]

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.

--org --organization

URL da organização do Azure DevOps. Exemplo: https://dev.azure.com/MyOrganizationName/. Se nenhuma organização for especificada, todas as organizações serão registradas em log.

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