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 /allow
alternativen , /deny
eller /remove
.
/global
Visar eller tilldelar en TFVC-samlingsnivåbehörighet. Om du vill tilldela behörigheter använder du /allow
alternativen , /deny
eller /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