通过

权限命令 （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]]

参数

参数

参数

说明

<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 组的成员更改 $/baseobjects TFVC 服务器文件夹中所有项目的本地副本：

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