TFSLabConfig Permissions (Comando)

Artículo
02/20/2013

Use el comando TFSLabConfig Permissions para establecer y obtener los permisos establecidos para un usuario especificado o para varios usuarios en un objeto especificado en Visual Studio Lab Management.Para obtener más información acerca de los permisos individuales, vea la sección Permisos de Lab Management de Permisos de Team Foundation Server.

Permisos necesarios

Para consultar permisos en un objeto, debe tener permisos de lectura para el objeto.Para cambiar permisos en un objeto del comando Permissions, debe tener el Manage Permissions permiso.De manera predeterminada, el creador del objeto tiene este permiso.Para obtener más información, vea Permisos de Team Foundation Server.

TFSLabConfig Permissions
      /Collection:collectionUrl
      [objectSpec]
      {[/User:userName1[,userName2][,...]]
      [/Group:groupName1[,groupName2][,...]]}
      [/Allow:{* |perm1[,perm2][,...] }] 
      [/Deny:{* |perm1[,perm2][,...]}]
      [/Remove:{* |perm1[,perm2][,...]}]
      [/Inherit:Yes|No]

Parámetros

Opción	Descripción
Collection:collectionUrl	Requerido.La dirección URL de la colección de proyectos de equipo en el nivel de aplicación de Team Foundation Server.Por ejemplo, /collection:http://abc:8080/TFS/DefaultCollection.
objectSpec	Opcional.Especifica el objeto de destino como un proyecto de equipo o recurso compartido de biblioteca al que se aplican los permisos.Para obtener información acerca de cómo especificar objetos, vea objectSpec a continuación.
User:userName1[,userName2][,...]	Opcional.Especifica uno o más usuarios a los que se aplican los permisos.Use comas para separar varios nombres de usuario.
Group:groupName1[,groupName2][,...]	Opcional.Especifica uno o más grupos a los que se aplican los permisos.Use comas para separar varios nombres de grupo.
Allow:{* \|perm1[,perm2][,...]}	Opcional.Habilita los permisos especificados para los usuarios o grupo especificados.Use un asterisco () para especificar todos los permisos.Para especificar un permiso individual, use los identificadores de la columna Name at command line* de la tabla en la sección Permisos de Lab Management de Permisos de Team Foundation Server.Use comas para separar varios permisos.
Deny:{* \|perm1[,perm2][,...]}	Opcional.Deniega los permisos especificados para los usuarios o grupo especificados.Use un asterisco () para especificar todos los permisos.Para especificar un permiso individual, use los identificadores de la columna Name at command line* de la tabla en la sección Permisos de Lab Management de Permisos de Team Foundation Server.Use comas para separar varios permisos.
Remove:{* \|perm1[,perm2][,...]}	Opcional.No establece los permisos especificados que se concedieron o denegaron previamente al usuario o grupo.Para especificar un permiso individual, use los identificadores de la columna Name at command line de la tabla en la sección Permisos de Lab Management de Permisos de Team Foundation Server.Use comas para separar varios permisos.
Inherit:Yes\|No	Opcional.Si especifica Yes, un elemento hereda todos los permisos asociados a una ACL principal.No se puede combinar con las opciones /remove, /user o /group.

objectSpec

Puede especificar de dos formas los objetos que desea incluir en el comando TFSLabConfig Permissions:

Use una o más opciones de ubicaciones para especificar el objeto en la jerarquía Lab Management.
Use la opción /Url para especificar el objeto como un identificador Uri.

Si no se especifica la opción del parámetro objectSpec, los permisos se aplican a todos los objetos de la colección del proyecto de equipo.

Opciones de tipo de objeto

En la siguiente tabla se enumera la combinación válida de opciones que puede usar para especificar un objeto como el parámetro objectSpec de un comando TFSLabConfig permissions

Para establecer permisos en	Use estas opciones
Un grupo host específico en una colección de proyectos de equipo	/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName
Un recurso compartido de biblioteca específico en una colección de proyectos de equipo	/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName
Todos los grupos host en un proyecto de equipo	/TeamProject:projectName/TeamProjectHostGroup:*
Un grupo host en un proyecto de equipo	/TeamProject:projectName/TeamProjectHostGroup:teamProjectHostGroupName
Un entorno de laboratorio en un grupo host para un proyecto de equipo	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName/LabEnvironment:labEnvironmentName
Todos los recursos compartido de biblioteca en un proyecto de equipo	/TeamProject:projectName/TeamProjectLibraryShare:*
Un recurso compartido de biblioteca en un proyecto de equipo	/TeamProject:projectName/TeamProjectLibraryShare:teamProjectLibraryShareName
Una plantilla de laboratorio en un recurso compartido de biblioteca de un proyecto de equipo	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName
Un entorno de laboratorio en un recurso compartido de biblioteca para un proyecto de equipo	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName

Url

Use la siguiente sintaxis para especificar el objeto de destino objectSpec de un comando TFSLabConfig permissions mediante la opción /Url:

**/url:VSTFS:///LabManagement/objectType/**objectId

El identificador objectId es el único identificador numérico del objeto.

En la siguiente tabla se enumeran las palabras clave de la palabra clave objectType:

Object (Tipo)	Descripción
TeamProjectCollectionHostGroup	Un grupo host de una colección de proyectos de equipo
TeamProjectCollectionLibraryShare	Un recurso compartido de biblioteca de una colección de proyectos de equipo
TeamProject	Un proyecto de equipo
TeamProjectHostGroup	Un grupo host de un proyecto de equipo
TeamProjectLibraryShare	Un recurso compartido de biblioteca de un proyecto de equipo
LabTemplate	Una máquina virtual o plantilla en un recurso compartido de biblioteca de proyectos de equipo
LabEnvironment	Un entorno implementado en un grupo host de proyectos de equipo o almacenado en un recurso compartido de biblioteca de proyectos de equipo.

Permisos

Puede especificar uno o más permisos Lab Management como destino de las opciones /Allow, /Deny o /Remove.Para obtener una lista de los premisos disponibles, vea la sección Lab Management Permissions del tema Permisos de Team Foundation Server.