Label-Befehl (Team Foundation-Versionskontrolle)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Der tf label-Befehl der Team Foundation-Versionskontrolle (TFVC) fügt eine Bezeichnung einer Version einer Datei oder eines Ordners auf dem TFVC-Server hinzu oder entfernt sie daraus.
Voraussetzungen
Um den label-Befehl zu verwenden, müssen Sie die Berechtigung Bezeichnung auf Zulassen festlegen. Zum Ändern oder Löschen von Bezeichnungen, die von anderen Benutzern erstellt wurden, muss die Berechtigung Bezeichnungen verwalten auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.
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]
Parameter
Argumente
Argument
Beschreibung
<labelname>
Gibt den Namen der Bezeichnung an, die an die angegebenen Elemente angefügt, geändert oder entfernt werden soll.
@<scope>
Gibt ein TFVC-Serververzeichnis an, in dem labelname eindeutig ist. Mit diesem Parameter können Sie unabhängig voneinander eine Bezeichnung oder einen Satz von Elementen mit Bezeichnungen erstellen, verwalten, abrufen und löschen, wenn sich zwei gleichnamige Bezeichnungen in verschiedenen Teilen des TFVC-Servers befinden.
<ownername>
Stellt einen Wert wie DOMAIN\JuanGo oder nur juango für die /owner-Option bereit.
<itemspec>
Gibt die Datei oder den Ordner an, die bzw. der mit einer Bezeichnung versehen, neu mit einer Bezeichnung versehen oder geändert werden soll. Weitere Informationen dazu, wie TFVC die itemspec analysiert, um zu bestimmen, welche Elemente in ihrem Gültigkeitsbereich liegen, finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.
Hinweis
Sie können mehrere itemspec-Argumente angeben.
<versionspec>
Stellt einen Wert wie c2 für die /version-Option bereit. Weitere Informationen dazu, wie TFVC eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente in ihrem Gültigkeitsbereich liegen, finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.
<comment>
Ein vom Benutzer bereitgestellter Kommentar zur Bezeichnung.
@<commentfile>
Der vom Benutzer bereitgestellte Pfad einer Datei auf dem Datenträger, die den Kommentar enthält, der für die Bezeichnung verwendet werden soll.
<username>
Stellt einen Wert für die /login-Option bereit. Sie können einen Benutzernamenwert als DOMAIN\username oder username angeben.
<TeamProjectCollectionUrl>
Die URL der angegebenen Projektsammlung, die eine Version einer Datei oder eines Ordners enthält, an die bzw. den Sie eine Bezeichnung anfügen möchten oder aus der oder dem Sie eine Bezeichnung löschen möchten, z. B http://myserver:8080/tfs/DefaultCollection.
Tastatur
Option
Beschreibung
/owner
Gibt den Namen des Benutzers an, der Besitzer der Bezeichnung ist.
/version
Optional. Gibt die Version der Datei oder des Ordners an, für die die Bezeichnung angefügt, geändert oder entfernt werden soll. Dies sind Changesetwerte, z. B C93. Standardmäßig verwendet TFVC die Basisarbeitsbereichversion, wenn keine versionspec angegeben wird.
/comment
Fügt eine Beschreibung oder einen Kommentar für die Bezeichnung hinzu oder ändert die Beschreibung oder den Kommentar.
/child
Nicht dokumentiert.
/recursive
Versieht alle Elemente im Verzeichnis, die mit Ihrer itemspec und versionspec übereinstimmen, mit einer Bezeichnung. Kann nicht mit der Option /delete verwendet werden.
/delete
Entfernt die Bezeichnung.
/login
Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.
/collection
Gibt die Projektsammlung an.
Hinweise
Eine Bezeichnung ist ein Marker, den Sie an eine Gruppe von Dateien und Ordnern auf dem TFVC-Server anfügen können, die ansonsten nicht in Beziehung stehen. Verwenden Sie die Bezeichnung, um das Abrufen von Dateien und Ordnern in einem Arbeitsbereich für Entwicklungs- oder Buildzwecke zu vereinfachen. Eine Bezeichnung ähnelt einem Changeset oder Datums-/Uhrzeitangabe. Sie können ihr beliebig Dateien und Ordner hinzufügen bzw. aus ihr entfernen oder die Versionen der darin enthaltenen Elemente ändern. Eine Bezeichnung ist eine Versionsspezifikation, die an die folgenden TFVC-Befehle übergeben werden kann:
Gängige Bezeichnungstypen sind Meilensteinbezeichnungen wie M1, Beta2 oder Release Candidate 0.
Bezeichnungen sind versionsspezifisch. Das heißt, Sie können nur eine Bezeichnung an eine Version einer Datei oder eines Ordners anfügen. Jede Version eines Elements kann mehrere Bezeichnungen unterstützen.
Eine Bezeichnung ist kein Objekt mit Versionsangabe. Daher wird der Bezeichnungsverlauf von Dateien nicht nachverfolgt. Außerdem erstellt ein Bezeichnungsvorgang keine ausstehende Änderung in Ihrem Arbeitsbereich. Wenn Sie den label-Befehl ausgeben, wird das Update sofort auf dem TFVC-Server angezeigt.
Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.
Entfernen und Löschen von Bezeichnungen
Sie können den Unlabel-Befehl verwenden, um eine Bezeichnung aus einer Datei oder einem Ordner zu entfernen. Alternativ können Sie eine Bezeichnung mithilfe des tf label /delete-Befehls aus dem System löschen.
Informationen zu einer vorhandenen Bezeichnung, die eine Liste der Elemente enthält, an die die Bezeichnung angefügt wurde, deren Kommentar, Bereich und Besitzer finden Sie unter Labels-Befehl.
Verwalten überladener Bezeichnungen
Bezeichnungsnamen müssen in einem angegebenen Bereich eindeutig sein. Wenn Sie eine Bezeichnung hinzufügen, reservieren Sie die Verwendung dieses Bezeichnungsnamens bei oder unter dem angegebenen oder implizierten Bereich. Der Standardwert für den @scope-Parameter ist das Projekt, z. B. $/TeamProject1.
Wenn ein anderes Team oder ein Benutzer eine allgemeine Bezeichnung wie M3 einer Gruppe versionsgesteuerter Dateien in einem anderen Teil des TFVC-Servers hinzufügt, können Sie die M3-Bezeichnung auf versionsgesteuerte Dateien in Ihrem Projekt anwenden, solange sich die Ordner des Stammprojekts in unterschiedlichen Verzeichnissen befinden. Wenn beispielsweise Dateien im Verzeichnis $/math mit der Bezeichnung M3 versehen sind, können Sie die M3-Bezeichnung auch auf Dateien in Ihrem Verzeichnis $/projects anwenden.
Um eine Bezeichnung abzurufen, zu entfernen oder Ihre mit der Bezeichnung M3 versehenen Elemente anderweitig zu verwalten, sollten Sie den Parameter @scope angeben, um TFVC mitzuteilen, mit welcher M3-Bezeichnung Sie arbeiten möchten.
Sie können verhindern, dass andere Benutzer eine Bezeichnung wie M3 in verschiedenen Teilen des TFVC-Servers „überladen“, indem Sie Ihre Bezeichnung entweder im Stamm $/ des Team Foundation-Versionskontrollservers erstellen oder die Berechtigung Bezeichnung für bestimmte Ordner anpassen.
Beispiele
Im folgenden Beispiel wird die goodbuild-Bezeichnung an die Arbeitsbereichversion des Ordners docs und die darin enthaltenen Dateien und Ordner angefügt.
c:\projects>tf label goodbuild docs /recursive
Im folgenden Beispiel wird die goodbuild-Bezeichnung an den Ordner docs angefügt, aber nicht an die Dateien und Ordner, die der Ordner docs enthält.
c:\projects>tf label goodbuild docs
Im folgenden Beispiel wird die goodbuild-Bezeichnung an Version 3 von 314.cs auf dem TFVC-Server angefügt.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
Im folgenden Beispiel wird die badbuild-Bezeichnung von allen Elementen auf dem TFVC-Server gelöscht.
c:\projects>tf label /delete badbuild
Im folgenden Beispiel wird die Bereichsoption @ verwendet, um eine Bezeichnung auf 314.cs anzuwenden.
c:\projects>tf label goodbuild@$/TeamProject1 314.cs