Compartilhar via


az devops security group

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 security group. Saiba mais sobre extensões.

Gerenciar grupos de segurança.

Comandos

Nome Description Tipo Status
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 group create

Crie um novo grupo do Azure DevOps.

az devops security group create [--description]
                                [--detect {false, true}]
                                [--email-id]
                                [--groups]
                                [--name]
                                [--org --organization]
                                [--origin-id]
                                [--project]
                                [--scope {organization, project}]

Exemplos

Criar um grupo do Azure DevOps com nome e descrição

az devops security group create --name 'Some group name'
--description 'Something to describe this group'

Adicionar um grupo do AAD existente a um grupo do Azure DevOps

Get object ID of an existing AAD group
az ad group show -g '{Group Name}'
az devops security group create --origin-id '{Object ID}' --groups 'vssgp.someDescriptorForGroup'

Adicionar um grupo do AAD existente a um grupo do Azure DevOps com a ID de Email do grupo do AAD

az devops security group create --email-id '{Email ID of AAD group}'
--groups 'vssgp.someDescriptorForGroup'

Crie um novo grupo do Azure DevOps e adicione-o aos grupos existentes do Azure DevOps.

az devops security group create --name 'Some group name'
--groups 'vssgp.someDescriptorForGroupOne,vssgp.someDescriptorForGroupTwo'

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.

--description

Descrição do grupo Azure DevOps.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--email-id

Crie um novo grupo usando o endereço de email como referência a um grupo existente de um provedor externo com suporte do AD ou do AAD. Obrigatório se o nome ou id de origem estiver ausente.

--groups

Uma lista separada por vírgulas de descritores que fazem referência a grupos que você deseja que o grupo recém-criado participe.

--name

Nome do grupo Azure DevOps.

--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/.

--origin-id

Crie um novo grupo usando o OriginID como referência a um grupo existente de um provedor externo com suporte do AD ou do AAD. Obrigatório se o nome ou a ID de email estiver ausente.

--project -p

Nome ou ID do projeto no qual o grupo do Azure DevOps deve ser criado.

--scope

Criar grupo no nível do projeto ou da organização.

Propriedade Valor
Valor padrão: project
Valores aceitos: organization, project
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 security group delete

Excluir um grupo do Azure DevOps.

az devops security group delete --id
                                [--detect {false, true}]
                                [--org --organization]
                                [--yes]

Parâmetros Exigidos

--id

Descritor do grupo.

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
--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/.

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
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 security group list

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

az devops security group list [--continuation-token]
                              [--detect {false, true}]
                              [--org --organization]
                              [--project]
                              [--scope {organization, project}]
                              [--subject-types]

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.

--continuation-token

Se houver mais resultados que não podem ser retornados em uma única página, o conjunto de resultados conterá um token de continuação para recuperação do próximo conjunto de resultados.

--detect

Detecte automaticamente a organização.

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/.

--project -p

Listar grupos para um projeto específico.

--scope

Listar grupos no nível do projeto ou da organização.

Propriedade Valor
Valor padrão: project
Valores aceitos: organization, project
--subject-types

Uma lista separada por vírgulas de subtipos de entidade de usuário para reduzir os resultados recuperados. Você pode dar a parte inicial do descritor [antes do ponto] como um filtro, por exemplo, vssgp,aadgp.

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 security group show

Mostrar detalhes do grupo.

az devops security group show --id
                              [--detect {false, true}]
                              [--org --organization]

Parâmetros Exigidos

--id

Descritor do grupo.

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
--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 devops security group update

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

az devops security group update --id
                                [--description]
                                [--detect {false, true}]
                                [--name]
                                [--org --organization]

Parâmetros Exigidos

--id

Descritor do grupo.

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.

--description

Nova descrição do grupo Azure DevOps.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--name

Novo nome para o grupo Azure DevOps.

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