Delen via

Git-machtigingsopdracht

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

Visual Studio 2019 | Visual Studio 2022

Met de opdracht tf git permission wordt de ACL (User Access Control List) gewijzigd en worden autorisatie-instellingen weergegeven voor een Git-opslagplaats of -vertakking in een Git-opslagplaats.

Voorwaarden

Categorie Requirements
toestemmingen - Machtigingen voor projectverzameling weergeven: Informatiemachtigingen op verzamelingsniveau weergeven die zijn ingesteld op Toestaan.
- Projectmachtigingen weergeven: informatie op projectniveau weergeven op Toestaan.
- Opslagplaats- en vertakkingsmachtigingen weergeven: Leesmachtigingen ingesteld op Toestaan.
- Machtigingen beheren: machtigingen beheren voor de gewenste artefacten die zijn ingesteld op Toestaan.

Zie Standaardmachtigingen voor Gitvoor meer informatie.

Syntaxis

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

Parameters

Parameter Beschrijving
/allow:(* |<perm1>[,<perm2>,...]) De machtigingen die moeten worden toegestaan.
/deny:(* |<perm1>[,<perm2>,...]) De machtigingen om te weigeren.
/remove:(* |<perm1>[,<perm2>,...]) De machtigingen die moeten worden verwijderd, worden soms niet ingesteld. U kunt alle drie de /allow, /denyen /remove in dezelfde aanroep gebruiken. Zie Machtigingsinstellingenvoor meer informatie over de interactie tussen instellingen voor toestaan, weigeren en verwijderen.
/user:<username1>[,<username2>,...] De gebruiker of gebruikers waarvoor machtigingen mogen worden toegestaan, geweigerd of verwijderd. U moet ten minste één gebruiker of groep opgeven.
/group:<groupname1>[,<groupname2>,...] De groepen of groepen waarvoor machtigingen kunnen worden toegestaan, geweigerd of verwijderd. U moet ten minste één gebruiker of groep opgeven. Groepen en personen kunnen samen worden gebruikt.
/collection:<TeamProjectCollectionUrl> Hiermee geeft u de URL op van de projectverzameling die de machtigingen bevat om te bekijken of te wijzigen. Bijvoorbeeld: http://myserver:8080/tfs/DefaultCollection of https://fabrikam-fiber.visualstudio.com. Deze parameter is vereist.
/teamproject:<TeamProjectIdentifier> Hiermee geeft u de naam op van het project dat de machtigingen bevat om te bekijken of te wijzigen.
/repository:<RepositoryIdentifier> Hiermee geeft u de naam op van de opslagplaats die de machtigingen bevat om te bekijken of te wijzigen.
/branch:<BranchName> Hiermee geeft u de naam op van de vertakking die de machtigingen bevat om te bekijken of te wijzigen. Als u /branchopgeeft, moet u ook /repositoryopgeven.
/login:<username>[,<password>] Hiermee geeft u het gebruikersaccount om de opdracht uit te voeren. Zie Opdrachten voor versiebeheer van Team Foundation gebruiken.

Zie naamruimten voor git-opslagplaatsmachtigingen voor een lijst met machtigingen die kunnen worden beheerd met de opdracht tf git permission.

Voorbeelden

Notitie

De volgende voorbeelden zijn onderverdeeld in meerdere regels voor leesbaarheid. Als u ze in de opdrachtregel wilt kopiëren en plakken en uitvoeren, kopieert u ze eerst en plakt u ze in Kladblok of een ander hulpprogramma en bewerkt u ze zodat de opdrachten op één regel staan.

Machtigingen op verzamelingsniveau weergeven

In het volgende voorbeeld ziet u de machtigingen voor de fabrikam-fiber verzameling.

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

Machtigingen op projectniveau weergeven

In het volgende voorbeeld ziet u de machtigingen op projectniveau voor het FabrikamFiber project, dat zich in de verzameling fabrikam-fiber bevindt.

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

Machtigingen op opslagplaatsniveau weergeven

In het volgende voorbeeld ziet u de machtigingen op projectniveau voor de FabrikamFiber opslagplaats, die zich in het FabrikamFiber project bevindt.

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

Opdrachten voor vertakkingsmappen vereisen

In de volgende voorbeelden ziet u hoe u een vertakkingsbeleid maakt waarmee de volgende beperkingen worden afgedwongen:

  • Alleen main kunnen bestaan in de hoofdmap van de opslagplaats.
  • Alle gebruikers mogen vertakkingen maken onder de mappen features/ en users/.
  • Beheerders kunnen vertakkingen maken onder de map releases/.

In dit voorbeeld gebruikt u de volgende verzameling, project en opslagplaats:

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

Blokkeer eerst de CreateBranch machtiging in de hoofdmap van de opslagplaats voor de inzenders van het project.

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

Sta vervolgens inzenders toe om vertakkingen te maken onder features en 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

Beheerders toestaan om vertakkingen te maken onder releases.

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

Ten slotte kunnen beheerders een vertakking maken met de naam main, voor het geval deze ooit per ongeluk wordt verwijderd.

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