Delen via

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 een label wordt gekoppeld aan of verwijderd uit een versie van een bestand of map op de TFVC-server.

Voorwaarden

Als u de opdracht label wilt gebruiken, moet u de labelmachtiging ingesteld op Toestaan. Als u labels wilt wijzigen of verwijderen die door andere gebruikers zijn gemaakt, moet u de Labels beheren machtigingen instellen op Toestaan. Zie standaard TFVC-machtigingenvoor 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 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 voor de optie /owner.

<itemspec>

Hiermee wordt het bestand of de map aangegeven waaruit u een label wilt toevoegen, opnieuw labelt of wijzigt. Zie Team Foundation-versiebeheeropdrachtengebruiken voor meer informatie over hoe TFVC de 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 optie /version. Zie Team Foundation-versiebeheeropdrachten gebruikenvoor 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 optie /login. U kunt een gebruikersnaamwaarde opgeven als DOMAIN\username of username.

<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

Facultatief. 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 wijzigingensetwaarden, bijvoorbeeld 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 optie /delete.

/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 opdracht label geeft, wordt de update onmiddellijk doorgevoerd in de TFVC-server.

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

Labels verwijderen en verwijderen

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

Zie opdracht Labelsvoor 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 parameter @scope is het project, bijvoorbeeld $/TeamProject1.

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

Als u een label wilt ophalen, verwijderen of anderszins uw M3-gelabelde items wilt beheren, moet u de parameter @scope opgeven om TFVC te laten weten 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 op de hoofdmap $/ van de Team Foundation-versiebeheerserver of door Label machtigingen voor bepaalde mappen aan te passen.

Voorbeelden

In het volgende voorbeeld wordt het label goodbuild 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 label goodbuild toegevoegd aan de docs map, 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 label badbuild verwijderd uit alle items op de TFVC-server.

c:\projects>tf label /delete badbuild

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

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