Dela via

Etikettkommando (Versionskontroll för Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Kommandot Team Foundation Version Control (TFVC) tf label bifogar en etikett till eller tar bort en etikett från en version av en fil eller mapp på TFVC-servern.

Förutsättningar

Om du vill använda kommandot label har du behörigheten Etikett inställd på Tillåt. Om du vill ändra eller ta bort etiketter som skapats av andra användare har Administrera etiketter behörighet inställd på Tillåt. Mer information finns i TFVC-standardbehörigheter.

Syntax

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parametrar

Argument

Argument

Beskrivning

<labelname>

Identifierar namnet på etiketten som ska bifogas, ändra eller ta bort från de angivna objekten.

@<scope>

Anger en TFVC-serverkatalog där labelname är unik. Med den här parametern kan du skapa, hantera, hämta och ta bort en etikett eller uppsättning etiketterade objekt när två etiketter med samma namn finns i olika delar av TFVC-servern.

<ownername>

Innehåller ett värde som DOMAIN\JuanGo eller bara juango till alternativet /owner.

<itemspec>

Identifierar den fil eller mapp som ska märkas, märkas om eller ändras från. Mer information om hur TFVC parsar itemspec för att avgöra vilka objekt som finns inom omfånget finns i Använda Team Foundation-versionskontrollkommandon.

Not

Du kan ange mer än ett itemspec argument.

<versionspec>

Innehåller ett värde som c2 för alternativet /version. Mer information om hur TFVC parsar en versionsspecifikation för att avgöra vilka objekt som ligger inom dess omfång finns i Använda Team Foundation-versionskontrollkommandon.

<comment>

En kommentar från användaren om etiketten.

@<commentfile>

Sökvägen som användaren anger för en fil på disken som innehåller kommentaren som ska användas för etiketten.

<username>

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

<TeamProjectCollectionUrl>

URL:en för den angivna projektsamlingen som innehåller en version av en fil eller mapp som du vill koppla en etikett till eller som du vill ta bort en etikett från, till exempel http://myserver:8080/tfs/DefaultCollection.

Alternativ

alternativ

Beskrivning

/owner

Anger namnet på den användare som äger etiketten.

/version

Valfri. Anger vilken version av filen eller mappen som etiketten ska kopplas till, ändras eller från vilken etiketten ska tas bort. Det här är ändringsuppsättningsvärden, till exempel C93. Som standard använder TFVC basarbetsytans version om ingen versionspec tillhandahålls.

/comment

Lägger till eller ändrar en beskrivning eller kommentar för etiketten.

/child

Inte dokumenterat.

/recursive

Etiketterar alla objekt i katalogen som matchar din itemspec och versionspec. Det går inte att använda med alternativet /delete.

/delete

Tar bort etiketten.

/login

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

/collection

Anger projektsamlingen.

Anmärkningar

En etikett är en markör som du kan koppla till en uppsättning annars orelaterade filer och mappar på TFVC-servern. Använd etiketten för att förenkla hämtningen av filer och mappar till en arbetsyta i utvecklings- eller byggsyfte. En etikett är som en ändringsuppsättning eller datum/tid till vilken och från vilken du godtyckligt kan lägga till och ta bort filer och mappar eller ändra versionerna av objekten däri. En etikett är en versionsspecifikation som kan skickas till följande TFVC-kommandon:

Vanliga typer av etiketter är milstolpeetiketter som M1, Beta2eller Release Candidate 0.

Etiketter är versionsspecifika. Du kan alltså bara koppla en etikett till en version av en fil eller mapp. Varje version av ett objekt har stöd för flera etiketter.

En etikett är inte ett versionsobjekt. Därför spåras inte filernas etiketthistorik. En etikettåtgärd skapar inte heller någon väntande ändring på arbetsytan. När du utfärdar kommandot label återspeglas uppdateringen omedelbart på TFVC-servern.

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

Ta bort och ta bort etiketter

Du kan använda kommandot Unlabel för att ta bort en etikett från en fil eller mapp. Du kan också ta bort en etikett från systemet med hjälp av kommandot tf label /delete.

Information om en befintlig etikett som innehåller en lista över de objekt som etiketten har kopplats till, dess kommentar, omfattning och ägare finns i kommandot Labels.

Hantera överlagrade etiketter

Etikettnamn måste vara unika i ett angivet omfång. När du lägger till en etikett reserverar du användningen av etikettnamnet på eller under det angivna eller underförstådda omfånget. Standardvärdet för parametern @scope är projektet, till exempel $/TeamProject1.

Om ett annat team eller en annan användare lägger till en gemensam etikett, till exempel M3 till en uppsättning versionskontrollerade filer i en annan del av TFVC-servern, kan du använda etiketten M3 på versionskontrollerade filer i projektet så länge rotprojektmapparna finns i olika kataloger. Om filer i katalogen $/math till exempel är märkta M3kan du även använda etiketten M3 på filer i katalogen $/projects.

Om du vill hämta, ta bort en etikett eller på annat sätt hantera dina M3-märkta objekt bör du ange parametern @scope för att tala om för TFVC vilken M3 etikett du vill arbeta med.

Du kan förhindra att andra användare "överbelastar" en etikett, till exempel M3 i olika delar av TFVC-servern genom att antingen skapa etiketten i rot-$/ på Team Foundation-versionskontrollservern eller genom att justera Etikett behörigheter för vissa mappar.

Exempel

I följande exempel kopplas etiketten goodbuild till arbetsyteversionen av dokument mapp och de filer och mappar som den innehåller.

c:\projects>tf label goodbuild docs /recursive

I följande exempel bifogas etiketten goodbuild till mappen docs men inte till de filer och mappar som dokument mapp innehåller.

c:\projects>tf label goodbuild docs

I följande exempel kopplas etiketten goodbuild till version 3 av 314.cs på TFVC-servern.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

I följande exempel tas etiketten badbuild bort från alla objekt på TFVC-servern.

c:\projects>tf label /delete badbuild

I följande exempel används omfångsalternativet @ för att tillämpa en etikett på 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs