Compartir a través de

Comando Permission (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | de Visual Studio 2022

El comando tf permission modifica la lista de control de acceso de usuario (ACL) y muestra la configuración de autorización de un elemento de Control de versiones de Team Foundation (TFVC).

Prerrequisitos

Para usar el comando permission, tenga la configuración de seguridad Manipular la configuración de seguridad establecido en Permitir para las carpetas que se están modificando, ser miembro del grupo de seguridad de Administradores de Azure DevOps o ser administrador del sistema en el equipo local (grupo de seguridad administrador de Windows). Para obtener más información, consulte permisos predeterminados de TFVC.

Sintaxis

tf permission [/allow:(* |perm1[,perm2,...]] 
[/deny:(* |perm1[,perm2,...])] [/remove:(* |perm1[,perm2,...])] 
[/inherit:yes|no] [/user:username1[,username2,...]] 
[/group:groupname1[,groupname2,...]] [/collection:TeamProjectCollectionUrl] 
[/recursive] itemspec [/global][/login:username,[password]]

Parámetros

Argumentos

de argumentos de

descripción

<permission>

Nombre de un permiso o rol que se va a modificar. Para más información sobre los nombres de permisos, consulte Grupos de seguridad, cuentas de servicio y permisos en Azure DevOps.

<username>

Valor de la opción /user. Un valor de nombre de usuario se puede expresar como DOMAIN\username o username, en función de la configuración de red.

<groupname>

Valor proporcionado por el usuario para la opción /group.

<TeamProjectCollectionUrl>

Dirección URL de la colección de proyectos que contiene el elemento para el que se van a modificar los permisos, por ejemplo, http://myserver:8080/tfs/DefaultCollection.

<itemspec>

Archivo o carpeta para el que se van a modificar los permisos. Para obtener más información sobre cómo TFVC analiza un itemspec para determinar qué elementos están dentro del ámbito, consulte Usar comandos de control de versiones de Team Foundation.

Nota

Puede especificar más de un argumento itemspec.

<username>

Proporciona un valor a la opción /login. Puede especificar un valor de nombre de usuario como DOMAIN\username o username.

Opciones

de opción de

descripción

/allow

Especifica una lista de permisos de TFVC que se van a agregar a la ACL permitida.

/deny

Especifica una lista de permisos de acceso de TFVC denegados para agregar a la ACL de usuario.

/remove

Especifica una lista de permisos de TFVC que se van a quitar de las ACL permitidas y de denegación.

/inherit

Si yes, el elemento hereda todos los permisos asociados a una ACL primaria. No se puede combinar con la opción /remove.

/user

Especifica el nombre de un usuario para el que se modificarán los permisos.

/group

Especifica el nombre del grupo para el que se van a modificar los permisos.

/collection

Especifica la colección de proyectos.

/recursive

Aplica el comando especificado a todos los elementos del directorio y a todos los subdirectorios.

La opción /recursive solo funciona al ver los permisos. No funciona al establecer permisos, por ejemplo, con las opciones de /allow, /denyo /remove.

/global

Vistas o asigna un permiso de nivel de colección de TFVC. Para asignar permisos, use las opciones de /allow, /denyo /remove. El argumento itemspec no es necesario. Si aparece, se omite.

Cuando se usa para ver una colección TFVC, enumera los cinco permisos siguientes:

  • tf: AdminShelvesets
  • tf: AdminWorkspaces
  • tf: CreateWorkspace
  • tf: AdminConfiguration
  • tf: AdminConnections

Para obtener más información, consulte Grupos de nivel de colección.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.

Observaciones

Puede usar el comando permission o su perm de acceso directo para administrar la configuración de autorización para objetos de servidor TFVC. Sin embargo, este comando no permite administrar la configuración de autenticación, como crear o modificar grupos de seguridad de Azure DevOps.

Para obtener más información sobre cómo usar la utilidad de línea de comandos de tf, consulte Usar comandos de control de versiones de Team Foundation.

Ejemplos

En el ejemplo siguiente se muestran las ACL de TFVC para 314.cs:

c:\projects>tf permission 314.cs

En el ejemplo siguiente se muestra la información de ACL del grupo de developers de la colección en http://myserver:8080/tfs/DefaultCollection/:

c:\projects>tf permission /group:[teamproject]\developers /collection: http://myserver:8080/tfs/DefaultCollection/

En el ejemplo siguiente se permite que los miembros del grupo de leads cambien sus copias locales de todos los elementos del $/baseobjects carpeta del servidor TFVC:

c:\projects>tf permission /allow:PendChange /group:[teamproject]\leads $/baseobjects

En el ejemplo siguiente se quitan todas las configuraciones relacionadas con los permisos de la carpeta $/baseobjects de para los miembros del grupo de :

c:\projects>tf permission /remove:* /group:developers $/baseobjects

En el ejemplo siguiente se permite que el grupo de testers cambie sus copias locales de todos los elementos de $/testproject:

c:\projects>tf permission /allow:PendChange /group:testers$/testproject

En el ejemplo siguiente se permite al usuario somealias realizar cambios pendientes en su copia local de $/testproject/314.cs en su área de trabajo:

c:\projects>tf permission /allow:PendChange /user:somealias $/testproject/314.cs.

En el ejemplo siguiente se deniega al usuario somealias la capacidad de realizar cambios pendientes en su copia local de $/testproject/1256.cs:

c:\projects>tf permission /deny:PendChange /user:somealias $/testproject/1256.cs