Partilhar via

Comando de permissão Git

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando tf git permission modifica a lista de controlo de acesso (ACL) dos utilizadores e apresenta as definições de autorização de um repositório Git ou ramificação num repositório Git.

Pré-requisitos

  • Para exibir permissões, você deve ser capaz de exibir o artefato para o tipo de informação que está solicitando: Exibir informações no nível da coleção para coleções de projetos, Exibir informações no nível do projeto para projetos e Ler para repositório e ramificação se estiver visualizando permissões de ramificação.

  • Para gerenciar permissões, você deve ter permissões de gerenciamento para o artefato desejado.

Para obter mais informações, consulte Permissões padrão do Git.

Sintaxe

tf git permission [/allow:(* |perm1[,perm2,...]] 
                  [/deny:(* |perm1[,perm2,...])]
                  [/remove:(* |perm1[,perm2,...])]
                  [/user:username1[,username2,...]]
                  [/group:groupname1[,groupname2,...]]
                  /collection:TeamProjectCollectionUrl
                  [/teamproject:TeamProjectIdentifier]
                  [/repository:RepositoryIdentifier]
                  [/branch:BranchName]
                  [/login:username,[password]]

Parâmetros

Parâmetro Description
/allow:(* |<perm1>[,<perm2>,...]) As permissões para permitir.
/deny:(* |<perm1>[,<perm2>,...]) As permissões para negar.
/remove:(* |<perm1>[,<perm2>,...]) As permissões para remover, às vezes referidas como não definidas. Você pode usar todos os três de /allow, /denye /remove na mesma invocação. Para obter mais informações sobre como as configurações de permissão, negação e remoção interagem, consulte Configurações de permissão.
/user:<username1>[,<username2>,...] O usuário ou usuários para os quais permitir, negar ou remover permissões. Você deve especificar pelo menos um usuário ou grupo.
/group:<groupname1>[,<groupname2>,...] Os grupos ou grupos para os quais permitir, negar ou remover permissões. Você deve especificar pelo menos um usuário ou grupo. Grupos e indivíduos podem ser usados juntos.
/collection:<TeamProjectCollectionUrl> Especifica a URL da coleção de projetos que contém as permissões para exibir ou modificar. Por exemplo: http://myserver:8080/tfs/DefaultCollection ou https://fabrikam-fiber.visualstudio.com. Este parâmetro é obrigatório.
/teamproject:<TeamProjectIdentifier> Especifica o nome do projeto que contém as permissões para exibir ou modificar.
/repository:<RepositoryIdentifier> Especifica o nome do repositório que contém as permissões para exibir ou modificar.
/branch:<BranchName> Especifica o nome da ramificação que contém as permissões para exibir ou modificar. Se você especificar /branch, também deverá especificar /repository.
/login:<username>[,<password>] Especifica a conta de usuário para executar o comando. Consulte Usar comandos de controle de versão do Team Foundation.

Consulte Namespaces de permissão do repositório Git para obter uma lista das permissões que podem ser administradas pelo tf git permission comando.

Exemplos

Nota

Os exemplos a seguir são divididos em várias linhas para facilitar a leitura. Para copiá-los e colá-los na linha de comando e executá-los, primeiro copie-os e cole-os no Bloco de Notas ou em outra ferramenta e edite-os para que os comandos estejam contidos em uma única linha.

Exibir permissões de nível de coleção

O exemplo a seguir lista as permissões para a fabrikam-fiber coleção.

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

Exibir permissões no nível do projeto

O exemplo a seguir lista as permissões de nível de projeto para o FabrikamFiber projeto, que está na fabrikam-fiber coleção.

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /teamproject:FabrikamFiber
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

Exibir permissões no nível do repositório

O exemplo a seguir lista as permissões de nível de projeto para o FabrikamFiber repositório, que está no FabrikamFiber projeto.

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /teamproject:FabrikamFiber 
                  /repository:FabrikamFiber 
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

Exigir comandos de pastas ramificadas

Os exemplos a seguir mostram como criar uma política de ramificação que impõe as seguintes restrições:

  • Só main pode existir na raiz do repositório.
  • Todos os usuários terão permissão para criar ramificações sob as features/ pastas e users/ .
  • Os administradores poderão criar ramificações na releases/ pasta.

Neste exemplo, você usa a seguinte coleção, projeto e repositório:

  • /collection: https://fabrikam-fiber.visualstudio.com
  • /teamproject: FabrikamProject
  • /repository FabrikamRepo

Primeiro, bloqueie a CreateBranch permissão na raiz do repositório para os contribuidores do projeto.

tf git permission /deny:CreateBranch 
                  /group:[FabrikamProject]\Contributors 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo

Em seguida, permita que os colaboradores criem ramificações em features e users.

tf git permission /allow:CreateBranch 
                  /group:[FabrikamProject]\Contributors 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:features

tf git permission /allow:CreateBranch 
                  /group:[FabrikamProject]\Contributors 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:users

Permitir que os administradores criem ramificações em releases.

tf git permission /allow:CreateBranch 
                  /group:"[FabrikamProject]\Project Administrators" 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:releases

Finalmente, permita que os administradores criem uma ramificação chamada main, caso ela seja excluída acidentalmente.

tf git permission /allow:CreateBranch 
                  /group:"[FabrikamProject]\Project Administrators" 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:main