Compartir a través de

Comando de permiso de Git

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019

Visual Studio 2019 | de Visual Studio 2022

El comando tf git permission modifica la lista de control de acceso de usuario (ACL) y muestra la configuración de autorización de un repositorio o rama de Git dentro de un repositorio de Git.

Prerrequisitos

  • Para ver los permisos, puede ver el artefacto para el tipo de información que solicita: Ver información de nivel de colección para colecciones de proyectos, Ver información de nivel de proyecto para proyectos y Leer para repositorio y rama si está viendo permisos de rama.

  • Para administrar los permisos, tenga Administrar permisos para el artefacto deseado.

Para obtener más información, consulte permisos de Git predeterminados.

Sintaxis

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 Descripción
/allow:(* |<perm1>[,<perm2>,...]) Permisos que se van a permitir.
/deny:(* |<perm1>[,<perm2>,...]) Permisos para denegar.
/remove:(* |<perm1>[,<perm2>,...]) Los permisos para quitar, a veces conocidos como no establecidos. Puede usar los tres /allow, /denyy /remove en la misma invocación. Para obtener más información sobre cómo interactúa la configuración de permitir, denegar y quitar, consulte Configuración de permisos.
/user:<username1>[,<username2>,...] Usuario o usuarios para los que se van a permitir, denegar o quitar permisos. Debe especificar al menos un usuario o grupo.
/group:<groupname1>[,<groupname2>,...] Grupos o grupos para los que se van a permitir, denegar o quitar permisos. Debe especificar al menos un usuario o grupo. Los grupos y las personas se pueden usar juntos.
/collection:<TeamProjectCollectionUrl> Especifica la dirección URL de la colección de proyectos que contiene los permisos para ver o modificar. Por ejemplo: http://myserver:8080/tfs/DefaultCollection o https://fabrikam-fiber.visualstudio.com. Este parámetro es obligatorio.
/teamproject:<TeamProjectIdentifier> Especifica el nombre del proyecto que contiene los permisos para ver o modificar.
/repository:<RepositoryIdentifier> Especifica el nombre del repositorio que contiene los permisos para ver o modificar.
/branch:<BranchName> Especifica el nombre de la rama que contiene los permisos para ver o modificar. Si especifica /branch, también debe especificar /repository.
/login:<username>[,<password>] Especifica la cuenta de usuario para ejecutar el comando. Consulte Usar comandos de control de versiones de Team Foundation.

Consulte los espacios de nombres de permisos del repositorio de Git para obtener una lista de los permisos que el comando tf git permission puede administrar.

Ejemplos

Nota

Los ejemplos siguientes se dividen en varias líneas para mejorar la legibilidad. Para copiarlos y pegarlos en la línea de comandos y ejecutarlos, cópielos primero y péguelos en el Bloc de notas u otra herramienta y edítelos para que los comandos estén contenidos en una sola línea.

Visualización de permisos de nivel de colección

En el ejemplo siguiente se enumeran los permisos de la colección fabrikam-fiber.

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

Visualización de permisos de nivel de proyecto

En el ejemplo siguiente se enumeran los permisos de nivel de proyecto para el proyecto de FabrikamFiber, que se encuentra en la colección fabrikam-fiber.

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

Visualización de permisos de nivel de repositorio

En el ejemplo siguiente se enumeran los permisos de nivel de proyecto para el repositorio de FabrikamFiber, que se encuentra en el proyecto de FabrikamFiber.

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

Requerir comandos de carpetas de rama

En los ejemplos siguientes se muestra cómo crear una directiva de rama que aplique las restricciones siguientes:

  • Solo main puede existir en la raíz del repositorio.
  • Todos los usuarios podrán crear ramas en las carpetas features/ y users/.
  • Los administradores podrán crear ramas en la carpeta releases/.

En este ejemplo se usan la siguiente colección, proyecto y repositorio:

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

En primer lugar, bloquee el permiso CreateBranch en la raíz del repositorio para los colaboradores del proyecto.

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

A continuación, permita que los colaboradores creen ramas en features y 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 los administradores creen ramas en releases.

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

Por último, permita a los administradores crear una rama denominada main, en caso de que alguna vez se elimine accidentalmente.

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