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 kopplar 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 label kommandot måste du ha behörigheten Etikett inställd på Tillåt. Om du vill ändra eller ta bort etiketter som skapats av andra användare måste du ha behörigheten Administrera etiketter 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 är labelname 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>

Ger 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.

Kommentar

Du kan ange mer än ett itemspec argument.

<versionspec>

Ger ett värde, till exempel 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 alternativet ett värde /login . Du kan ange ett användarnamnsvärde 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 bifoga 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

Valfritt. 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 inget versionspec anges.

/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.

Kommentarer

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 label kommandot återspeglas uppdateringen omedelbart på TFVC-servern.

Mer information om hur du använder tf kommandoradsverktyget 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 tf label /delete av kommandot .

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 Etiketter.

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 M3 etiketten 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 M3 etiketten för filer i katalogen $/projects .

Om du vill hämta, ta bort en etikett eller på annat sätt hantera dina M3etiketterade 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 roten $/ på Team Foundation-versionskontrollservern eller genom att justera Etikettbehörigheter för vissa mappar.

Exempel

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

c:\projects>tf label goodbuild docs /recursive

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

c:\projects>tf label goodbuild docs

I följande exempel bifogas goodbuild etiketten 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 bort badbuild 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