Delen via

Git-machtigingsopdracht

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Met de opdracht tf git permission wijzigt u de ACL-lijst (toegangsbeheerlijst) voor gebruikers en geeft u autorisatie-instellingen weer voor een Git-opslagplaats of -vertakking binnen een Git-opslagplaats.

Vereisten

  • Als u machtigingen wilt weergeven, moet u het artefact kunnen weergeven voor het type informatie dat u aanvraagt: informatie op verzamelingsniveau weergeven voor projectverzamelingen, informatie op projectniveau weergeven voor projecten en lezen voor opslagplaats en vertakking als u vertakkingsmachtigingen bekijkt.

  • Als u machtigingen wilt beheren, moet u machtigingen beheren voor het gewenste artefact hebben.

Zie Standaardmachtigingen voor Git voor 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 Description
/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 /allowde, /denyen /remove in dezelfde aanroep gebruiken. Zie Machtigingsinstellingen voor meer informatie over hoe de instellingen toestaan, weigeren en verwijderen werken.
/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 opgeeft /branch, moet u ook opgeven /repository.
/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 machtigingen voor Git-opslagplaatsen voor een lijst met de machtigingen die door de tf git permission opdracht kunnen worden beheerd.

Voorbeelden

Notitie

De volgende voorbeelden zijn onderverdeeld in meerdere regels voor leesbaarheid. Als u ze wilt kopiëren en plakken in de opdrachtregel en deze wilt 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 fabrikam-fiber verzameling 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 bevinden.

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 kan bestaan in de hoofdmap van de opslagplaats.
  • Alle gebruikers mogen vertakkingen maken onder de features/ en users/ mappen.
  • Beheer istrators kunnen vertakkingen onder de releases/ map maken.

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 onder releaseste maken.

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