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 服务器权限时,列出的五项权限为:
有关权限的更多信息,请参见 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