TFSLabConfig Permissions 命令

项目
02/22/2013

使用 TFSLabConfig Permissions 命令可以设置和获取指定用户或多个用户对Visual Studio 实验室管理工具版中指定对象的权限。有关单个权限的更多信息，请参见 Team Foundation Server 权限的 Lab Management 权限节。

必需的权限

若要查询对象权限，您必须具备“读取”该对象的权限。若要更改 Permissions 所支配的对象的权限，您必须具备 Manage Permissions 权限。默认情况下，对象的创建者具有此权限。有关更多信息，请参见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]

参数

选项	说明
Collection:collectionUrl	必需。团队项目所在的应用层 Team Foundation Server 的 URL。例如 /collection:http://abc:8080/TFS/DefaultCollection。
objectSpec	可选。指定权限应用到的目标对象（如团队项目和库共享）。有关如何指定对象的信息，请参见下面的 objectSpec。
User:userName1[,userName2][,...]	可选。指定权限应用到的一个或多个用户。可使用逗号分隔多个用户名称。
Group:groupName1[,groupName2][,...]	可选。指定权限应用到的一个或多个组。可使用逗号分隔多个组名称。
Allow:{* \|perm1[,perm2][,...]}	可选。对指定用户或组启用指定的权限。使用星号 () 指定所有权限。若要指定单个权限，请使用 Team Foundation Server 权限 Lab Management 权限一节中的表的 Name at command line* 列中的标识符。可使用逗号分隔多个权限。
Deny:{* \|perm1[,perm2][,...]}	可选。对指定用户拒绝指定的权限。使用星号 () 指定所有权限。若要指定单个权限，请使用 Team Foundation Server 权限 Lab Management 权限一节中的表的 Name at command line* 列中的标识符。可使用逗号分隔多个权限。
Remove:{* \|perm1[,perm2][,...]}	可选。未设置以前授予用户或组的指定权限。若要指定单个权限，请使用 Team Foundation Server 权限 Lab Management 权限一节中的表的 Name at command line 列中的标识符。可使用逗号分隔多个权限。
Inherit:Yes\|No	可选。如果指定 Yes，则项会继续与父 ACL 关联的所有权限。不能与 /remove、/user 或 /group 选项一起使用。

objectSpec

您可以以两种方式指定要在 TFSLabConfig Permissions 命令中包含的对象：

使用一个或多个位置选项指定实验室管理工具版层次结构中的对象。
使用 /Url 选项将对象指定为 Uri。

如果未指定 objectSpec 参数选项，则权限将应用于团队项目集合中的所有对象。

对象类型选项

下表列出您可用于将对象指定为 TFSLabConfig permissions 命令的 objectSpec 参数的选项的有效组合。

若要设置权限	使用这些选项
团队项目组合中的指定主机组	/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName
团队项目组合中的指定库共享	/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName
团队项目中的所有组主机	/TeamProject:projectName /TeamProjectHostGroup:*
在团队项目中的一组主机	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName
团队项目的主机组中的实验室环境	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName /LabEnvironment:labEnvironmentName
团队项目中的所有库共享	/TeamProject: projectName /TeamProjectLibraryShare:*
团队项目中的库共享	/TeamProject: projectName /TeamProjectLibraryShare:teamProjectLibraryShareName
团队项目的库共享中的实验室模板	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName
团队项目的库共享中的实验室环境	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName

Url

使用以下语法通过使用 /Url 选项指定 TFSLabConfig permissions 命令的 objectSpec 目标对象：

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

objectId 是该对象唯一的数字标识符。

下表列出 objectType 密码的有效密码：

对象类型	说明
TeamProjectCollectionHostGroup	团队项目集合的主机组
TeamProjectCollectionLibraryShare	团队项目集合的库共享
TeamProject	团队项目
TeamProjectHostGroup	团队项目的主机组
TeamProjectLibraryShare	团队项目的库共享
LabTemplate	团队项目库共享中的虚拟机或模板
LabEnvironment	在团队项目主机组上部署的或在团队项目库共享中存储的环境。