Comando di autorizzazione Git

2025-01-10

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

Visual Studio 2019 | Visual Studio 2022

Il comando tf git permission modifica l'elenco di controllo di accesso utente (ACL) e visualizza le impostazioni di autorizzazione per un repository Git o un ramo all'interno di un repository Git.

Prerequisiti

Per visualizzare le autorizzazioni, è possibile visualizzare l'artefatto per il tipo di informazioni richieste: Visualizzare le informazioni a livello di raccolta per le raccolte di progetti, Visualizzare le informazioni a livello di progetto per i progetti e Leggi per repository e ramo se si visualizzano le autorizzazioni di ramo.
Per gestire le autorizzazioni, disporre di Gestire le autorizzazioni per l'artefatto desiderato.

Per altre informazioni, vedere Autorizzazioni Git predefinite.

Sintassi

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

Parametri

Parametro	Descrizione
`/allow:(* \|<perm1>[,<perm2>,...])`	Autorizzazioni da consentire.
`/deny:(* \|<perm1>[,<perm2>,...])`	Autorizzazioni da negare.
`/remove:(* \|<perm1>[,<perm2>,...])`	Autorizzazioni da rimuovere, talvolta definite non impostate. È possibile usare tutte e tre le `/allow`, `/deny`e `/remove` nella stessa chiamata. Per altre informazioni sull'interazione tra le impostazioni di autorizzazione, negazione e rimozione, vedere Impostazioni di autorizzazione.
`/user:<username1>[,<username2>,...]`	L'utente o gli utenti per i quali consentire, negare o rimuovere le autorizzazioni. È necessario specificare almeno un utente o un gruppo.
`/group:<groupname1>[,<groupname2>,...]`	Gruppi o gruppi per i quali consentire, negare o rimuovere autorizzazioni. È necessario specificare almeno un utente o un gruppo. I gruppi e i singoli utenti possono essere usati insieme.
`/collection:<TeamProjectCollectionUrl>`	Specifica l'URL della raccolta di progetti che contiene le autorizzazioni per visualizzare o modificare. Ad esempio: `http://myserver:8080/tfs/DefaultCollection` o `https://fabrikam-fiber.visualstudio.com`. Questo parametro è obbligatorio.
`/teamproject:<TeamProjectIdentifier>`	Specifica il nome del progetto che contiene le autorizzazioni per visualizzare o modificare.
`/repository:<RepositoryIdentifier>`	Specifica il nome del repository che contiene le autorizzazioni per visualizzare o modificare.
`/branch:<BranchName>`	Specifica il nome del ramo che contiene le autorizzazioni per visualizzare o modificare. Se si specifica `/branch`, è necessario specificare anche `/repository`.
`/login:<username>[,<password>]`	Specifica l'account utente per eseguire il comando. Vedere Usare i comandi di controllo della versione di Team Foundation.

Vedere gli spazi dei nomi delle autorizzazioni del repository Git per un elenco delle autorizzazioni che è possibile amministrare dal comando tf git permission.

Esempi

Nota

Gli esempi seguenti sono suddivisi in più righe per migliorare la leggibilità. Per copiarli e incollarli nella riga di comando ed eseguirli, copiarli e incollarli nel Blocco note o in un altro strumento e modificarli in modo che i comandi siano contenuti in una singola riga.

Visualizzare le autorizzazioni a livello di raccolta

Nell'esempio seguente vengono elencate le autorizzazioni per la raccolta fabrikam-fiber.

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

Visualizzare le autorizzazioni a livello di progetto

Nell'esempio seguente vengono elencate le autorizzazioni a livello di progetto per il progetto FabrikamFiber, che si trova nella raccolta fabrikam-fiber.

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

Visualizzare le autorizzazioni a livello di repository

Nell'esempio seguente vengono elencate le autorizzazioni a livello di progetto per il repository FabrikamFiber, che si trova nel progetto FabrikamFiber.

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

Richiedere i comandi delle cartelle dei rami

Gli esempi seguenti illustrano come creare criteri di ramo che applicano i vincoli seguenti:

Solo main possono esistere nella radice del repository.
Tutti gli utenti potranno creare rami nelle cartelle features/ e users/.
Gli amministratori potranno creare rami nella cartella releases/.

In questo esempio si usa la raccolta, il progetto e il repository seguenti:

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

Prima di tutto, bloccare l'autorizzazione CreateBranch nella radice del repository per i collaboratori del progetto.

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

Consentire quindi ai collaboratori di creare rami in features e 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

Consentire agli amministratori di creare rami in releases.

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

Infine, consentire agli amministratori di creare un ramo denominato main, nel caso in cui venga eliminato accidentalmente.

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

comando di visualizzazione Git