Permission 命令
更新：2007 年 11 月
修改用户访问控制列表 (ACL) 并显示受版本控制的项的授权设置。
必需的权限
若要使用 permission 命令，您必须针对要修改的文件夹将“操作安全设置”权限设置为“允许”，或者必须是“Team Foundation Administrators”安全组的成员或本地计算机上的系统管理员（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,…]] [/server:servername]
[/recursive] itemspec [/global]
参数
参数 |
说明 |
|---|---|
perm |
要修改的权限或角色的名称。有关权限名称的更多信息，请参见 Team Foundation Server 权限。 |
Username |
向 /user 选项提供值。根据网络设置，username 值可以用两种方式之一来表示：DOMAIN\username 或 username。 |
Groupname |
用户提供的 /group 选项的值。 |
Servername |
用户提供的 /server 选项的值。示例：teamfoundation2。 |
Itemspec |
标识要修改其权限的文件或文件夹。有关 Team Foundation 如何分析 itemspecs 以确定哪些项在范围内的更多信息，请参见命令行语法 (Team System)。 |
选项 |
说明 |
|---|---|
/allow |
指定为允许 ACL 而添加的 Team Foundation 版本控制 权限列表。 |
/deny |
指定要添加到用户访问控制列表的被拒绝 Team Foundation 版本控制 访问权限列表。 |
/remove |
指定要从允许和拒绝的 ACL 中移除的 Team Foundation 版本控制 权限列表。 |
/inherit |
如果选择 yes，则与父 ACL 关联的所有权限均由项继承。无法与 /remove 选项一起使用。 |
/user |
指定要修改其权限的用户的名称。 |
/group |
要修改其权限的组的名称。 |
/server |
标识 Team Foundation Server。如果从未映射到工作区的目录调用命令，则此选项是必需的。 |
/recursive |
将指定命令应用到该目录及任意子目录中的所有项。 /recursive 选项只能用于查看源树中的项的权限。该选项不能用于设置权限，例如不能与 /allow、/deny 和 /remove 选项一起使用。 |
/global |
用于查看或分配任何 Team Foundation 服务器权限。 若要分配权限，请使用 /allow、/deny 或 /remove 选项。 不需要参数 itmespec。如果列出了该参数，将忽略。 当用于查看 Team Foundation 服务器权限时，列出的五项权限为：
有关权限的更多信息，请参见 Team Foundation Server 权限。 |
备注
可以使用 permission 命令（或其快捷方式 perm）指定可向哪个或哪组用户授予权限。
您可以使用 permission 命令管理 Team Foundation 版本控制 服务器对象的授权设置。但是，此命令不允许管理创建或修改 Team Foundation 安全组之类的授权设置。
有关如何查找“tf”命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例显示 314.cs 的 Team Foundation 访问控制列表 (ACL)。
c:\projects>tf permission 314.cs
下面的示例显示与 teamserver2 Team Foundation Server 的“developers”组有关的 ACL 信息。
c:\projects>tf permission /group:[teamproject]\developers /server:teamserver2
下面的示例允许“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
请参见
任务
演练：通过命令行使用 Team Foundation 版本控制