Permission 命令（Team Foundation 版本控制）

  • 项目

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

tf permission 命令修改用户访问控制列表 (ACL)，并在 Team Foundation 版本控制 (TFVC) 中显示项的授权设置。

先决条件

若要使用 permission 命令，必须将正在修改的文件夹的“操作安全设置”权限设置为“允许”、必须是“Azure DevOps 管理员”安全组的成员，或者必须是本地计算机上的系统管理员（“Windows 管理员”安全组）。 有关详细信息，请参阅默认 TFVC 权限。

语法

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]]

参数

参数

Argument

说明

<permission>

要修改的权限或角色的名称。 有关权限名称的详细信息，请参阅 Azure DevOps 中的安全组、服务帐户和权限。

<username>

/user 选项的值。 用户名值可以表示为 DOMAIN\username 或 username，具体取决于网络设置。

<groupname>

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

<TeamProjectCollectionUrl>

包含要修改其权限的项的项目集合的 URL，例如 http://myserver:8080/tfs/DefaultCollection。

<itemspec>

要修改其权限的文件或文件夹。 有关 TFVC 如何分析 itemspec 以确定哪些项在范围内的详细信息，请参阅使用 Team Foundation 版本控制命令。

注意

可指定多个 itemspec 参数。

<username>

为 /login 选项提供值。 可以将用户名值指定为 DOMAIN\username 或 username。

选项

选项

说明

/allow

指定要添加到允许 ACL 的 TFVC 权限列表。

/deny

指定要添加到用户 ACL 的被拒绝 TFVC 访问权限列表。

/remove

指定要从允许和拒绝 ACL 中删除的 TFVC 权限列表。

/inherit

如果为 yes，则该项继承与父 ACL 关联的所有权限。 无法与 /remove 选项合并。

/user

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

/group

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

/collection

指定项目集合。

/recursive

将指定的命令应用于目录和任何子目录中的所有项。

仅当查看权限时，/recursive 选项才有效。 设置权限（例如使用 /allow、/deny 或 /remove 选项设置）时，它不起作用。

/global

查看或分配 TFVC 集合级别权限。 若要分配权限，请使用 /allow、/deny 或 /remove 选项。 不需要 itemspec 参数。 如果已列出，则忽略它。

当用于查看 TFVC 集合时，列出以下五个权限：

  • tf: AdminShelvesets
  • tf: AdminWorkspaces
  • tf: CreateWorkspace
  • tf: AdminConfiguration
  • tf: AdminConnections

有关详细信息，请参阅集合级别组。

/login

指定用户名和密码，以便使用 Azure DevOps 对用户进行身份验证。

注解

可以使用 permission 命令或其快捷方式 perm 来管理 TFVC 服务器对象的授权设置。 但是，无法通过此命令管理身份验证设置，例如创建或修改 Azure DevOps 安全组。

有关如何使用 tf 命令行实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令。

示例

以下示例显示 314.cs 的 TFVC ACL：

c:\projects>tf permission 314.cs

以下示例显示 http://myserver:8080/tfs/DefaultCollection/ 处集合中 developers 组的 ACL 信息：

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

以下示例允许 leads 组成员更改 TFVC 服务器文件夹 $/baseobjects 中所有项的本地副本：

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 在其工作区中对 $/testproject/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