Permission 命令

  • 项目

修改用户访问控制列表 (ACL) 并显示受版本控制的项的授权设置。

所需权限

若要使用 permission 命令，您必须针对要修改的文件夹将**“操作安全设置”权限设置为“允许”，或者必须是“Team Foundation Administrators (Team Foundation 管理员)”**安全组的成员或本地计算机上的系统管理员（Windows Administrator 安全组）。 有关更多信息，请参见 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]]

参数

参数

说明

perm

要修改的权限或角色的名称。 有关权限名称的更多信息，请参见 Team Foundation Server 权限。

Username

向 /user 选项提供值。 根据网络设置，username 值可以用两种方式之一来表示：DOMAIN\username 或 username。

Groupname

用户提供的 /group 选项的值。

TeamProjectCollectionUrl

您要修改其权限的项所在的团队项目集合的 URL（例如，http://myserver:8080/tfs/DefaultCollection）。

Itemspec

标识要修改其权限的文件或文件夹。 有关 Team Foundation 如何分析 itemspecs 以确定哪些项在范围内的更多信息，请参见 命令行语法（版本控制）。

注意注意
可指定多个 Itemspec 参数。

Username

向 /login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。

选项

说明

/allow

指定为允许 ACL 而添加的 Team Foundation 版本控制 权限列表。

/deny

指定要添加到用户访问控制列表的被拒绝 Team Foundation 版本控制 访问权限列表。

/remove

指定要从允许和拒绝的 ACL 中移除的 Team Foundation 版本控制 权限列表。

/inherit

如果选择 yes，则与父 ACL 关联的所有权限均由项继承。 无法与 /remove 选项一起使用。

/user

指定要修改其权限的用户的名称。

/group

要修改其权限的组的名称。

/collection

指定团队项目集合。

/recursive

将指定命令应用到该目录及任意子目录中的所有项。

/recursive 选项只能用于查看源树中的项的权限。 该选项不能用于设置权限，例如不能与 /allow、/deny 和 /remove 选项一起使用。

/global

用于查看或分配任何 Team Foundation 服务器权限。

若要分配权限，请使用 /allow、/deny 或 /remove 选项。

不需要参数 itmespec。 如果列出了该参数，将忽略。

当用于查看 Team Foundation 服务器权限时，列出的五项权限为：

  • tf: AdminShelvesets

  • tf: AdminWorkspaces

  • tf: CreateWorkspace

  • tf: AdminConfiguration

  • tf: AdminConnections

有关权限的更多信息，请参见 Team Foundation Server 权限。

/login

指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。

备注

可以使用 permission 命令（或者其快捷方式 perm）管理 Team Foundation 版本控制 服务器对象的授权设置。 但是，此命令不允许管理创建或修改 Team Foundation 安全组之类的授权设置。

有关如何查找**“tf”**命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。

示例

下面的示例显示 314.cs 的 Team Foundation 访问控制列表 (ACL)。

c:\projects>tf permission 314.cs

下面的示例显示与位于 http://myserver:8080/tfs/DefaultCollection/ 上的集合的组“开发人员”有关的 ACL 信息。

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

下面的示例允许“leads”组的成员更改其在 $/baseobjects Team Foundation 版本控制 服务器文件夹中所有项的本地副本。

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

下面的示例从 $/baseobjects 文件夹中移除“developers”组成员的所有与权限相关的设置。

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

下面的示例允许“testers”组更改其在 $/testproject 中所有项的本地副本。

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

下面的示例允许用户 somealias 对其工作区内 $/testtproject/314.cs 的本地副本执行挂起的更改。

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

下面的示例拒绝用户 somealias 对其 $/testproject/1256.cs 的本地副本执行挂起的更改。

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

请参见

参考

命令行语法（版本控制）

其他资源

Tf 命令行实用工具命令