Behörighetskommando (Versionskontroll för Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

Kommandot tf permission ändrar användaråtkomstkontrollistan (ACL) och visar auktoriseringsinställningar för ett objekt i Team Foundation Version Control (TFVC).

Förutsättningar

Om du vill använda permission kommandot måste du ha behörigheten Manipulera säkerhetsinställningar inställd på Tillåt för mappar som ändras, vara medlem i säkerhetsgruppen Azure DevOps-administratörer eller vara systemadministratör på den lokala datorn (Windows-administratörssäkerhetsgrupp). Mer information finns i TFVC-standardbehörigheter.

Syntax

tf permission [/allow:(* |perm1[,perm2,...]] 
[/deny:(* |perm1[,perm2,...])] [/remove:(* |perm1[,perm2,...])] 
[/inherit:yes|no] [/user:username1[,username2,...]] 
[/group:groupname1[,groupname2,...]] [/collection:TeamProjectCollectionUrl] 
[/recursive] itemspec [/global][/login:username,[password]]

Parametrar

Argument

Argument

Beskrivning

<permission>

Namn på en behörighet eller roll som ska ändras. Mer information om behörighetsnamnen finns i Säkerhetsgrupper, tjänstkonton och behörigheter i Azure DevOps.

<username>

Värde för /user alternativet. Ett användarnamnsvärde kan uttryckas som DOMAIN\username eller username, beroende på nätverksinställningar.

<groupname>

Det användardefinierade värdet för /group alternativet.

<TeamProjectCollectionUrl>

URL:en för projektsamlingen som innehåller det objekt som behörigheter ska ändras för, till exempel http://myserver:8080/tfs/DefaultCollection.

<itemspec>

Den fil eller mapp som behörigheter ska ändras för. Mer information om hur TFVC parsar en itemspec för att avgöra vilka objekt som finns inom omfånget finns i Använda Team Foundation-versionskontrollkommandon.

Kommentar

Du kan ange mer än ett itemspec argument.

<username>

Ger alternativet ett värde /login . Du kan ange ett användarnamnsvärde som antingen DOMAIN\username eller username.

Alternativ

Alternativ

Beskrivning

/allow

Anger en lista över TFVC-behörigheter som ska läggas till i den tillåtna ACL:en.

/deny

Anger en lista över nekad TFVC-åtkomstbehörighet som ska läggas till i användarens ACL.

/remove

Anger en lista över TFVC-behörigheter att ta bort från både tillåtna och nekande-ACL:er.

/inherit

Om yesärver objektet alla behörigheter som är associerade med en överordnad ACL. Det går inte att kombinera med alternativet /remove .

/user

Anger namnet på en användare att ändra behörigheter för.

/group

Anger namnet på den grupp som behörigheterna ska ändras för.

/collection

Anger projektsamlingen.

/recursive

Tillämpar det angivna kommandot på alla objekt i katalogen och eventuella underkataloger.

Alternativet /recursive fungerar bara när du visar behörigheter. Det fungerar inte när du anger behörigheter, till exempel med /allowalternativen , /denyeller /remove .

/global

Visar eller tilldelar en TFVC-samlingsnivåbehörighet. Om du vill tilldela behörigheter använder du /allowalternativen , /denyeller /remove . Argumentet itemspec krävs inte. Om det visas ignoreras det.

När den används för att visa en TFVC-samling visas följande fem behörigheter:

  • tf: AdminShelvesets
  • tf: AdminWorkspaces
  • tf: CreateWorkspace
  • tf: AdminConfiguration
  • tf: AdminConnections

Mer information finns i Grupper på samlingsnivå.

/login

Anger användarnamn och lösenord för att autentisera användaren med Azure DevOps.

Kommentarer

Du kan använda permission kommandot eller dess genväg perm för att hantera auktoriseringsinställningar för TFVC-serverobjekt. Med det här kommandot kan du dock inte hantera autentiseringsinställningar som att skapa eller ändra Azure DevOps-säkerhetsgrupper.

Mer information om hur du använder tf kommandoradsverktyget finns i Använda Team Foundation-versionskontrollkommandon.

Exempel

I följande exempel visas TFVC-ACL:er för 314.cs:

c:\projects>tf permission 314.cs

I följande exempel visas ACL-informationen för developers gruppen i samlingen på http://myserver:8080/tfs/DefaultCollection/:

c:\projects>tf permission /group:[teamproject]\developers /collection: http://myserver:8080/tfs/DefaultCollection/

I följande exempel kan medlemmar i leads gruppen ändra sina lokala kopior av alla objekt i TFVC-servermappen $/baseobjects :

c:\projects>tf permission /allow:PendChange /group:[teamproject]\leads $/baseobjects

Följande exempel tar bort alla behörighetsrelaterade inställningar från mappen $/baseobjects för medlemmar i developers gruppen:

c:\projects>tf permission /remove:* /group:developers $/baseobjects

I följande exempel kan gruppen testers ändra sina lokala kopior av alla objekt i $/testproject:

c:\projects>tf permission /allow:PendChange /group:testers$/testproject

I följande exempel kan användaren somealias göra väntande ändringar i sin lokala kopia av $/testproject/314.cs på arbetsytan:

c:\projects>tf permission /allow:PendChange /user:somealias $/testproject/314.cs.

I följande exempel nekas användaren somealias möjligheten att göra väntande ändringar i sin lokala kopia av $/testproject/1256.cs:

c:\projects>tf permission /deny:PendChange /user:somealias $/testproject/1256.cs