Opdracht Label (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Met de opdracht Team Foundation Version Control (TFVC) tf label wordt een label gekoppeld aan of verwijderd uit een versie van een bestand of map op de TFVC-server.

Vereisten

Als u de label opdracht wilt gebruiken, moet de labelmachtiging zijn ingesteld op Toestaan. Als u labels wilt wijzigen of verwijderen die zijn gemaakt door andere gebruikers, moet u de machtiging Beheer isterlabels hebben ingesteld op Toestaan. Zie Standaard TFVC-machtigingen voor meer informatie.

Syntaxis

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]

Parameters

Argumenten

Argument

Beschrijving

<labelname>

Identificeert de naam van het label dat moet worden gekoppeld, gewijzigd of verwijderd uit de opgegeven items.

@<scope>

Hiermee geeft u een TFVC-servermap op waarin de labelname map uniek is. Met deze parameter kunt u onafhankelijk één label of set gelabelde items maken, beheren, ophalen en verwijderen wanneer twee labels met dezelfde naam zich in verschillende delen van de TFVC-server bevinden.

<ownername>

Biedt een waarde zoals DOMAIN\JuanGo of alleen juango aan de /owner optie.

<itemspec>

Hiermee wordt het bestand of de map aangegeven waaruit u een label wilt toevoegen, opnieuw labelt of wijzigt. Zie Team Foundation-opdrachten voor versiebeheer gebruiken voor meer informatie over hoe TFVC het itemspec parseert om te bepalen welke items binnen het bereik vallen.

Notitie

U kunt meer dan één itemspec argument opgeven.

<versionspec>

Biedt een waarde, zoals c2 voor de /version optie. Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over hoe TFVC een versiespecificatie parseert om te bepalen welke items binnen het bereik vallen.

<comment>

Een door de gebruiker verstrekte opmerking over het label.

@<commentfile>

Het door de gebruiker opgegeven pad van een bestand op schijf dat de opmerking bevat die moet worden gebruikt voor het label.

<username>

Biedt een waarde voor de /login optie. U kunt een gebruikersnaamwaarde opgeven als of DOMAIN\usernameusername.

<TeamProjectCollectionUrl>

De URL van de opgegeven projectverzameling die een versie van een bestand of map bevat waaraan u een label wilt toevoegen of waarvan u een label wilt verwijderen, bijvoorbeeld http://myserver:8080/tfs/DefaultCollection.

Opties

Optie

Beschrijving

/owner

Hiermee geeft u de naam op van de gebruiker die eigenaar is van het label.

/version

Optioneel. Hiermee geeft u de versie op van het bestand of de map waaraan het label moet worden gekoppeld, gewijzigd of waaruit het label moet worden verwijderd. Dit zijn bijvoorbeeld wijzigingensetwaarden C93. TFVC maakt standaard gebruik van de basiswerkruimteversie als er geen versionspec is opgegeven.

/comment

Hiermee voegt u een beschrijving of opmerking voor het label toe of wijzigt u deze.

/child

Niet gedocumenteerd.

/recursive

Hiermee worden alle items in de map gelabeld die overeenkomen met uw itemspec en versionspec. Kan niet worden gebruikt met de /delete optie.

/delete

Hiermee verwijdert u het label.

/login

Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met Azure DevOps.

/collection

Hiermee geeft u de projectverzameling op.

Opmerkingen

Een label is een markering die u kunt toevoegen aan een set bestanden en mappen die niet gerelateerd zijn aan de TFVC-server. Gebruik het label om het ophalen van bestanden en mappen naar een werkruimte te vereenvoudigen voor ontwikkelings- of builddoeleinden. Een label is vergelijkbaar met een wijzigingenset of datum/tijd waarop en waaruit u willekeurig bestanden en mappen kunt toevoegen en verwijderen of de versies van de items hierin kunt wijzigen. Een label is een versiespecificatie die kan worden doorgegeven aan de volgende TFVC-opdrachten:

Veelvoorkomende typen labels zijn mijlpaallabels zoals M1, Beta2of Release Candidate 0.

Labels zijn versiespecifiek. Dat wil gezegd, u kunt slechts een label toevoegen aan één versie van een bestand of map. Elke versie van een item kan meerdere labels ondersteunen.

Een label is geen versiebeheerobject. Daarom wordt de labelgeschiedenis van bestanden niet bijgehouden. Een labelbewerking maakt ook geen wijziging in behandeling in uw werkruimte. Wanneer u de label opdracht geeft, wordt de update onmiddellijk doorgevoerd in de TFVC-server.

Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over het gebruik van het tf opdrachtregelprogramma.

Labels verwijderen en verwijderen

U kunt de opdracht Label ongedaan maken gebruiken om een label uit een bestand of map te verwijderen. U kunt ook een label uit het systeem verwijderen met behulp van de tf label /delete opdracht.

Zie de opdracht Labels voor informatie over een bestaand label dat een lijst bevat met de items waaraan het label is gekoppeld, de opmerking, het bereik en de eigenaar.

Overbelaste labels beheren

Labelnamen moeten uniek zijn binnen een opgegeven bereik. Wanneer u een label toevoegt, reserveert u het gebruik van die labelnaam op of onder het opgegeven of impliciete bereik. De standaardwaarde voor de @scope parameter is het project, bijvoorbeeld $/TeamProject1.

Als een ander team of een andere gebruiker een gemeenschappelijk label toevoegt, zoals M3 een set versiebeheerde bestanden in een ander deel van de TFVC-server, kunt u het M3 label toepassen op versiebeheerde bestanden in uw project, zolang de hoofdprojectmappen zich in verschillende mappen bevinden. Als bijvoorbeeld bestanden in de map $/math zijn gelabeld M3, kunt u het M3 label ook toepassen op bestanden in de map $/projects .

Als u een label wilt ophalen, verwijderen of anderszins uw M3gelabelde items wilt beheren, moet u de @scope parameter opgeven om TFVC aan te geven met welk M3 label u wilt werken.

U kunt voorkomen dat andere gebruikers een label 'overbelasten' zoals M3 in verschillende delen van de TFVC-server door uw label te maken in de hoofdmap $/ van de team Foundation-versiebeheerserver of door labelmachtigingen voor bepaalde mappen aan te passen.

Voorbeelden

In het volgende voorbeeld wordt het goodbuild label gekoppeld aan de werkruimteversie van de docs-map en de bestanden en mappen die het bevat.

c:\projects>tf label goodbuild docs /recursive

In het volgende voorbeeld wordt het goodbuild label gekoppeld aan de map docs , maar niet aan de bestanden en mappen die de docs-map bevat.

c:\projects>tf label goodbuild docs

In het volgende voorbeeld wordt het goodbuild label gekoppeld aan versie 3 van 314.cs op de TFVC-server.

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

In het volgende voorbeeld wordt het badbuild label verwijderd uit alle items op de TFVC-server.

c:\projects>tf label /delete badbuild

In het volgende voorbeeld wordt de @ bereikoptie gebruikt om een label toe te passen op 314.cs.

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