Permission (Comando)

Modifica la lista de control de acceso (ACL) del usuario y muestra la configuración de autorización para un elemento bajo control de versiones.

Permisos necesarios

Para usar el comando permission, el permiso Manipular la configuración de seguridad debe estar establecido en Permitir para las carpetas que se van a modificar, debe ser miembro del grupo de seguridad Administradores de Team Foundation o debe ser un administrador del sistema en el equipo local (grupo de seguridad Administrador de Windows). Para obtener más información, vea Permisos de Team Foundation Server.

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

Argumento

Descripción

perm

Nombre del permiso o función que se va a modificar. Para obtener más información sobre los nombres de los permisos, vea Permisos de Team Foundation Server.

Username

Proporciona un valor para la opción /user. Un valor de nombre de usuario se puede expresar de una de dos maneras según la configuración de la red: DOMINIO\nombreDeUsuario o nombreDeUsuario.

Groupname

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

TeamProjectCollectionUrl

La dirección URL de la colección de proyectos de equipo que contiene el elemento para el que desea modificar los permisos (por ejemplo, http://myserver:8080/tfs/DefaultCollection).

Itemspec

Identifica el archivo o carpeta cuyos permisos se van a modificar. Para obtener más información sobre cómo Team Foundation analiza itemspecs para determinar qué elementos se encuentran en ese ámbito, vea Sintaxis de la línea de comandos (Control de versiones).

NotaNota
Puede especificar más de un argumento Itemspec.

Username

Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario.

Opción

Descripción

/allow

Especifica una lista de permisos de control de versiones de Team Foundation que se van a agregar a la ACL permitir.

/deny

Especifica una lista de permisos de acceso denegados de control de versiones de Team Foundation que se van a agregar a la lista de control de acceso del usuario.

/remove

Especifica una lista de permisos de control de versiones de Team Foundation que se van a quitar de las ACL permitir y denegar.

/inherit

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

/user

Especifica el nombre de un usuario cuyos permisos se van a modificar.

/group

Nombre del grupo cuyos permisos se van a modificar.

/collection

Especifica la colección del proyecto de equipo.

/recursive

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

La opción /recursive sólo funciona al consultar los permisos de los elementos de un árbol de origen. No funciona al establecer permisos, por ejemplo, con las opciones /allow, /deny y /remove.

/global

Se utiliza para ver o asignar los permisos de servidor de Team Foundation.

Para asignar los permisos, utilice las opciones /allow, /deny o /remove.

No se requiere el argumento itmespec. Si se incluye, se omite.

Cuando se utiliza para ver los permisos de servidor de Team Foundation, los cinco permisos que se muestran son los siguientes:

  • tf: AdminShelvesets

  • tf: AdminWorkspaces

  • tf: CreateWorkspace

  • tf: AdminConfiguration

  • tf: AdminConnections

Para obtener más información acerca de los permisos, vea Permisos de Team Foundation Server.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server.

Comentarios

Puede utilizar el comando permission (o su acceso directo perm) para administrar la configuración de autorización en los objetos de servidor de control de versiones de Team Foundation. Sin embargo, este comando no permite administrar las opciones de autenticación como crear o modificar los grupos de seguridad de Team Foundation.

Para obtener más información sobre cómo encontrar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.

Ejemplos

El ejemplo siguiente muestra las listas de control de acceso (ACL) de Team Foundation correspondientes a 314.cs.

c:\projects>tf permission 314.cs

En el siguiente ejemplo se muestra la información ACL relacionada con el grupo "desarrolladores de software" de la colección que se encuentra en http://myserver:8080/tfs/DefaultCollection/.

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

El ejemplo siguiente permite que los integrantes del grupo "leads" cambien sus copias locales de todos los elementos en la carpeta $/baseobjects del servidor control de versiones de Team Foundation.

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

El ejemplo siguiente quita todas las opciones de configuración relacionadas con los permisos de la carpeta $/baseobjects correspondientes a los integrantes del grupo "developers".

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

El ejemplo siguiente permite al grupo "testers" cambiar sus copias locales de todos los elementos de $/testproject.

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

El ejemplo siguiente permite al usuario somealias realizar los cambios pendientes en su copia local de $/testtproject/314.cs en su área de trabajo.

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

El ejemplo siguiente deniega al usuario somealias la capacidad de realizar los cambios pendientes en su copia local de $/testproject/1256.cs.

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

Vea también

Referencia

Sintaxis de la línea de comandos (Control de versiones)

Otros recursos

Comandos de la utilidad Tf de la línea de comandos