Dela via


Git-behörighetskommando

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

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

Förutsättningar

  • Om du vill visa behörigheter måste du kunna visa artefakten för den typ av information som du begär: Visa information på samlingsnivå för projektsamlingar, Visa information på projektnivå för projekt och Läsa för lagringsplats och gren om du visar grenbehörigheter.

  • Om du vill hantera behörigheter måste du ha Hantera behörigheter för den önskade artefakten.

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 Description
/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 av /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. Mer information finns i Använda kommandon för versionskontroll i Team Foundation.

En lista över de behörigheter som kan administreras av kommandot finns i tf git permission Namnområden för Git-lagringsplatsbehörighet.

Exempel

Kommentar

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 något 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 fabrikam-fiber samlingen.

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 fabrikam-fiber samlingen.

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:

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

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 behörigheten CreateBranch 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

Slutligen kan 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