共用方式為

權限命令 （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 Administrators 安全組的成員，或是本機計算機上的系統管理員（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

下列範例會顯示集合中 developers 群組在 http://myserver:8080/tfs/DefaultCollection/的 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