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>,...]) |
要移除的許可權，有時稱為未設定。 您可以在相同的呼叫中使用三個 /allow、/deny和 /remove。 如需允許、拒絕和移除設定互動方式的詳細資訊，請參閱 許可權設定。 |
/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可以存在於存放庫根目錄。 - 所有使用者都可以在
features/和users/資料夾下建立分支。 - 系統管理員可以在
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
然後，允許參與者在 features 下建立分支，並 users。
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