Git 權限命令
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
tf git permission 命令會修改使用者存取控制清單 (ACL)，並在 Git 存放庫內顯示 Git 存放庫或分支的授權設定。
必要條件
若要檢視許可權，您必須能夠檢視所要求資訊類型的成品：檢視專案集合的集合層級資訊、檢視專案的專案層級資訊，以及檢視存放庫和分支的讀取，如果您要檢視分支許可權。
若要管理許可權，您必須擁有 所需成品的管理許可權 。
如需詳細資訊，請參閱 預設 Git 許可權。
語法
tf git permission [/allow:(* |perm1[,perm2,...]]
[/deny:(* |perm1[,perm2,...])]
[/remove:(* |perm1[,perm2,...])]
[/user:username1[,username2,...]]
[/group:groupname1[,groupname2,...]]
/collection:TeamProjectCollectionUrl
[/teamproject:TeamProjectIdentifier]
[/repository:RepositoryIdentifier]
[/branch:BranchName]
[/login:username,[password]]
參數
| 參數 | 描述 |
|---|---|
/allow:(* |<perm1>[,<perm2>,...]) |
允許的許可權。 |
/deny:(* |<perm1>[,<perm2>,...]) |
要拒絕的許可權。 |
/remove:(* |<perm1>[,<perm2>,...]) |
要移除的許可權，有時稱為未設定。 您可以在相同的呼叫中使用、 與 /remove 這三/allow/deny個 。 如需允許、拒絕和移除設定互動方式的詳細資訊，請參閱 許可權設定。 |
/user:<username1>[,<username2>,...] |
要允許、拒絕或移除許可權的使用者。 您必須至少指定一個使用者或群組。 |
/group:<groupname1>[,<groupname2>,...] |
允許、拒絕或移除許可權的群組或群組。 您必須至少指定一個使用者或群組。 群組和個人可以一起使用。 |
/collection:<TeamProjectCollectionUrl> |
指定專案集合的 URL，其中包含檢視或修改的許可權。 例如：http://myserver:8080/tfs/DefaultCollection 或 https://fabrikam-fiber.visualstudio.com。 此為必要參數。 |
/teamproject:<TeamProjectIdentifier> |
指定包含檢視或修改許可權的項目名稱。 |
/repository:<RepositoryIdentifier> |
指定存放庫的名稱，其中包含檢視或修改的許可權。 |
/branch:<BranchName> |
指定包含檢視或修改許可權的分支名稱。 如果您指定 /branch，則亦須指定 /repository。 |
/login:<username>[,<password>] |
指定要執行命令的用戶帳戶。 請參閱 使用Team Foundation版本控制命令。 |
如需命令可管理tf git permission的許可權清單，請參閱 Git 存放庫許可權命名空間。
範例
注意
下列範例分成多行，以取得可讀性。 若要將它們複製並貼到命令行並加以執行，請先將它們複製並貼到 記事本 或其他工具，並加以編輯，讓命令包含在單一行上。
檢視集合層級許可權
下列範例會列出集合的許可權 fabrikam-fiber 。
tf git permission /collection:https://dev.azure.com/fabrikam-fiber
/login:FabrikamUser@hotmail.com,FabrikamPassword
檢視專案層級許可權
下列範例會列出集合中fabrikam-fiber專案的專案層級許可權FabrikamFiber。
tf git permission /collection:https://dev.azure.com/fabrikam-fiber
/teamproject:FabrikamFiber
/login:FabrikamUser@hotmail.com,FabrikamPassword
檢視存放庫層級許可權
下列範例會列出專案中存放庫FabrikamFiber的專案層級許可權FabrikamFiber。
tf git permission /collection:https://dev.azure.com/fabrikam-fiber
/teamproject:FabrikamFiber
/repository:FabrikamFiber
/login:FabrikamUser@hotmail.com,FabrikamPassword
需要分支資料夾命令
下列範例示範如何建立強制執行下列條件約束的分支原則：
- 只能
main存在於存放庫根目錄。 - 所有使用者都可以在和
users/資料夾下features/建立分支。 - 管理員 istrators 將能夠建立資料夾下的
releases/分支。
在此範例中，您會使用下列集合、專案和存放庫：
/collection: https://fabrikam-fiber.visualstudio.com/teamproject: FabrikamProject/repository FabrikamRepo
首先，封鎖 CreateBranch 項目參與者之存放庫根目錄的許可權。
tf git permission /deny:CreateBranch
/group:[FabrikamProject]\Contributors
/collection:https://dev.azure.com/fabrikam-fiber/
/teamproject:FabrikamProject
/repository:FabrikamRepo
然後，允許參與者在和 users下features建立分支。
tf git permission /allow:CreateBranch
/group:[FabrikamProject]\Contributors
/collection:https://dev.azure.com/fabrikam-fiber/
/teamproject:FabrikamProject
/repository:FabrikamRepo
/branch:features
tf git permission /allow:CreateBranch
/group:[FabrikamProject]\Contributors
/collection:https://dev.azure.com/fabrikam-fiber/
/teamproject:FabrikamProject
/repository:FabrikamRepo
/branch:users
允許系統管理員在下 releases建立分支。
tf git permission /allow:CreateBranch
/group:"[FabrikamProject]\Project Administrators"
/collection:https://dev.azure.com/fabrikam-fiber/
/teamproject:FabrikamProject
/repository:FabrikamRepo
/branch:releases
最後，允許系統管理員建立稱為 main的分支，以防意外刪除。
tf git permission /allow:CreateBranch
/group:"[FabrikamProject]\Project Administrators"
/collection:https://dev.azure.com/fabrikam-fiber/
/teamproject:FabrikamProject
/repository:FabrikamRepo
/branch:main