共用方式為

權限命令 （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 管理員 istrators 安全組的成員，或是本機計算機上的系統管理員（Windows 管理員 istrator 安全組）。 如需詳細資訊，請參閱 預設 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/中顯示群組的 ACL 資訊developers：

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

下列範例會從群組成員developers的 $/baseobjects 資料夾中移除所有許可權相關設定：

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