Dela via

Git-behörighetskommando

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2019 | Visual Studio 2022

Kommandot tf git permission ändrar användaråtkomstkontrollistan (ACL) och visar auktoriseringsinställningar för en Git-lagringsplats eller -gren på en Git-lagringsplats.

Förutsättningar

Kategori Kravspecifikation
behörigheter – Visa behörigheter för projektsamling: Visa informationsbehörigheter på samlingsnivå inställda på Tillåt.
– Visa projektbehörigheter: Visa information på projektnivå inställd på Tillåt.
– Visa lagringsplats- och grenbehörigheter: Läsbehörigheter har angetts till Tillåt.
– Hantera behörigheter: Hantera behörigheter för önskad artefakt inställd på Tillåt.

Mer information finns i Git-standardbehörigheter.

Syntax

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]]

Parametrar

Parameter Beskrivning
/allow:(* |<perm1>[,<perm2>,...]) Behörigheterna som ska tillåtas.
/deny:(* |<perm1>[,<perm2>,...]) Behörigheter att neka.
/remove:(* |<perm1>[,<perm2>,...]) Behörigheter att ta bort, kallas ibland inte för angivna. Du kan använda alla tre /allow, /denyoch /remove i samma anrop. Mer information om hur inställningar för att tillåta, neka och ta bort interagerar finns i Behörighetsinställningar.
/user:<username1>[,<username2>,...] Den användare eller de användare för vilka behörigheter ska tillåtas, nekas eller tas bort. Du måste ange minst en användare eller grupp.
/group:<groupname1>[,<groupname2>,...] De grupper eller grupper för vilka behörigheter ska tillåtas, nekas eller tas bort. Du måste ange minst en användare eller grupp. Grupper och individer kan användas tillsammans.
/collection:<TeamProjectCollectionUrl> Anger URL:en för den projektsamling som innehåller behörighet att visa eller ändra. Till exempel: http://myserver:8080/tfs/DefaultCollection eller https://fabrikam-fiber.visualstudio.com. Den här parametern krävs.
/teamproject:<TeamProjectIdentifier> Anger namnet på projektet som innehåller behörighet att visa eller ändra.
/repository:<RepositoryIdentifier> Anger namnet på lagringsplatsen som innehåller behörighet att visa eller ändra.
/branch:<BranchName> Anger namnet på den gren som innehåller behörighet att visa eller ändra. Om du anger /branchmåste du också ange /repository.
/login:<username>[,<password>] Anger vilket användarkonto som ska köra kommandot. Se Använda Team Foundation-versionskontrollkommandon.

En lista över de behörigheter som kan administreras av -kommandot finns i tf git permission.

Exempel

Not

Följande exempel är uppdelade i flera rader för läsbarhet. Om du vill kopiera och klistra in dem på kommandoraden och köra dem kopierar du dem först och klistrar in dem i Anteckningar eller ett annat verktyg och redigerar dem så att kommandona finns på en enda rad.

Visa behörigheter på samlingsnivå

I följande exempel visas behörigheterna för samlingen fabrikam-fiber.

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

Visa behörigheter på projektnivå

I följande exempel visas behörigheter på projektnivå för FabrikamFiber-projektet, som finns i samlingen fabrikam-fiber.

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /teamproject:FabrikamFiber
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

Visa behörigheter på lagringsplatsnivå

I följande exempel visas behörigheter på projektnivå för FabrikamFiber-lagringsplatsen, som finns i FabrikamFiber projektet.

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /teamproject:FabrikamFiber 
                  /repository:FabrikamFiber 
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

Kräv kommandon för grenmappar

I följande exempel visas hur du skapar en grenprincip som tillämpar följande begränsningar:

  • Endast main kan finnas på lagringsplatsens rot.
  • Alla användare får skapa grenar under mapparna features/ och users/.
  • Administratörer kommer att kunna skapa grenar under mappen releases/.

I det här exemplet använder du följande samling, projekt och lagringsplats:

  • /collection: https://fabrikam-fiber.visualstudio.com
  • /teamproject: FabrikamProject
  • /repository FabrikamRepo

Blockera först CreateBranch behörighet på lagringsplatsens rot för projektets deltagare.

tf git permission /deny:CreateBranch 
                  /group:[FabrikamProject]\Contributors 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo

Tillåt sedan deltagare att skapa grenar under features och 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

Tillåt administratörer att skapa grenar under releases.

tf git permission /allow:CreateBranch 
                  /group:"[FabrikamProject]\Project Administrators" 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:releases

Låt slutligen administratörer skapa en gren med namnet main, om den skulle tas bort av misstag.

tf git permission /allow:CreateBranch 
                  /group:"[FabrikamProject]\Project Administrators" 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:main