分享方式:


權限命令 (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\usernameusername

<groupname>

選項的使用者提供值 /group

<TeamProjectCollectionUrl>

專案集合的 URL,其中包含要修改權限的專案,例如 http://myserver:8080/tfs/DefaultCollection

<itemspec>

要修改許可權的檔案或資料夾。 如需 TFVC 如何剖析 itemspec 以判斷哪些專案在範圍內的詳細資訊,請參閱 使用 Team Foundation 版本控制命令

注意

您可以指定多個 itemspec 自變數。

<username>

提供 選項的值 /login 。 您可以將使用者名稱值指定為 DOMAIN\usernameusername

選項。

選項

說明

/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.csTFVC 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