Befehl Label (Team Foundation-Quellcodeverwaltung)
Fügt eine Bezeichnung von einer Version oder einer Datei bzw. einem Ordner auf dem Server für die Quellcodeverwaltung in Team Foundation hinzu.
tf label [/server:servername] labelname[@scope] [/owner:ownername]
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)]
[/child:(replace|merge)] [/recursive]
tf label [/server:servername] /delete labelname[@scope]
[/owner:ownername] itemspec [/version:versionspec] [/recursive]
Parameter
| Argument | Beschreibung |
|---|---|
servername |
Der vom Benutzer angegebene Wert für die /server-Option. Beispiel: teamfoundation2. |
labelname |
Identifiziert den Namen der Bezeichnung, die angefügt, geändert oder aus den angegebenen Elementen entfernt werden soll. |
@scope |
Gibt ein Verzeichnis auf dem Server für die Quellcodeverwaltung in Team Foundation an, innerhalb dessen der Bezeichnername eindeutig ist. Mit diesem Parameter können unabhängig eine Bezeichnung oder einen Satz von Elementen mit Bezeichnungen erstellen, verwalten, abrufen und löschen, wenn zwei Bezeichnungen mit demselben Namen in unterschiedlichen Bereichen des Servers für die Quellcodeverwaltung in Team Foundation vorhanden sind. |
ownername |
Stellt einen Wert, z. B. DOMÄNE\JuanGo oder nur juango, für die Option /owner bereit. |
itemspec |
Identifiziert die Datei oder den Ordner, in dem eine Bezeichnung hinzugefügt, erneuert oder geändert werden soll. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen. |
versionspec |
Gibt einen Wert für die /version-Option an, z. B. c2. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax. |
comment |
Ein vom Benutzer bereitgestellter Kommentar zu der Bezeichnung. |
@commentfile |
Der vom Benutzer bereitgestellte Pfad zu einer Datei auf dem Datenträger, die den für das Einchecken zu verwendenden Kommentar enthält. |
| Option | Beschreibung |
|---|---|
/server |
Identifiziert den Team Foundation Server. Diese Option ist erforderlich, wenn der Befehl von einem Verzeichnis aufgerufen wird, das keinem Arbeitsbereich zugeordnet ist. |
/owner |
Gibt den Namen des Benutzers an, der Besitzer der Bezeichnung ist. |
/version |
(Optional) Gibt die Version der Datei oder des Ordners an, in der bzw. dem die Bezeichnung angefügt, geändert oder entfernt werden soll. Diese sind Differenzmengenwerte, z. B. C93. Standardmäßig verwendet Team Foundation die Basisarbeitsbereichsversion, sofern kein versionspec bereitgestellt wird. |
/comment |
Fügt eine Beschreibung oder einen Kommentar für die Bezeichnung hinzu oder ändert diese bzw. diesen. |
/child |
Kennzeichnet die Behandlung von Elementen mit vorhandenen Bezeichnungen, die den von Ihnen angegebenen Bezeichnungen entsprechen. Mit Replace können Sie die Version des Elements aktualisieren, das der vorhandenen Bezeichnung entspricht. Mit Merge werden Elemente mit einer vorhandenen Bezeichnung unverändert belassen. |
/recursive |
Bezeichnet alle Elemente im Verzeichnis, die itemspec und versionspec entsprechen. |
/delete |
Entfernt die Bezeichnung aus allen angegebenen Elementen. |
Hinweise
Eine Bezeichnung ist eine Markierung, die Sie an einen Satz nicht zusammenhängender Dateien und Ordner auf dem Server für die Quellcodeverwaltung in Team Foundation anfügen können, um das Abrufen in einen Arbeitsbereich für die Entwicklung oder für Builds zu vereinfachen. Daher ähnelt eine Bezeichnung einer Differenzmenge oder Datum/Uhrzeit, mit deren Hilfe Sie zufällig Dateien und Ordner hinzufügen und entfernen oder die Versionen der enthaltenen Elemente ändern können. Eine Bezeichnung ist eine Versionsspezifikation, die an die folgenden Team Foundation-Befehle übergeben werden kann:
Häufig verwendete Typen von Bezeichnungen sind Meilensteinbezeichnungen, z. B. "M1", "Beta2" oder "Release Candidate 0."
Bezeichnungen sind versionsspezifisch, d. h., 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.
Standardmäßig ist der Befehl label nicht rekursiv. Wenn Sie einen Ordner auf dem Server für die Quellcodeverwaltung in Team Foundation mithilfe der folgenden Befehlssyntax beschriften, wendet Team Foundation die Bezeichnung auf den Projektordner an, aber nicht auf die im Projekt enthaltenen Dateien und Ordner: tf label M3.2 projects.
Eine Bezeichnung ist kein Objekt mit Versionsangabe, deshalb wird die Bezeichnungsversionsgeschichte von Dateien nicht verfolgt. Darüber hinaus wird bei einem Bezeichnungsvorgang keine ausstehende Änderung im Arbeitsbereich erstellt. Wenn Sie den Befehl label ausgeben, werden die entsprechenden Aktualisierungen sofort auf dem Server für die Quellcodeverwaltung in Team Foundation angezeigt.
Entfernen und Löschen von Bezeichnungen
Sie können den Befehl Unlabel verwenden, um eine Bezeichnung aus einer Datei oder einem Ordner zu entfernen. Wahlweise können Sie mit dem Befehl tf label /delete eine Bezeichnung aus dem System löschen.
Weitere Informationen über eine vorhandene Bezeichnung mit einer Liste der Elemente, an die die Bezeichnung angefügt wurde, ihren Kommentaren, Gültigkeitsbereich und Besitzer finden Sie unter Befehl Labels.
Verwalten von überladenen Bezeichnungen
Bezeichnungsnamen müssen innerhalb eines angegebenen Bereichs eindeutig sein. Wenn Sie eine Bezeichnung hinzufügen, reservieren Sie die Verwendung dieses Bezeichnungsnamens in oder unterhalb des angegebenen oder impliziten Bereichs. Der Standardwert für den @scope-Parameter ist das Teamprojekt, z. B. $/TeamProject1.
Wenn ein anderes Team oder ein anderer Benutzer eine allgemeine Bezeichnung wie "M3" zu einem Satz von Quelldateien in einem anderen Bereich des Servers für die Quellcodeverwaltung in Team Foundation hinzufügt, können Sie die Bezeichnung M3 auf Quelldateien in Ihrem Projekt anwenden, sofern die Stammprojektordner in unterschiedlichen Verzeichnissen enthalten sind. Wenn z. B. die Dateien im Verzeichnis $/math mit "M3" beschriftet werden, können Sie "M3" auch auf Dateien im Verzeichnis $/projects anwenden.
Zum Abrufen oder Entfernen einer Bezeichnung oder zur Verwaltung von Elementen mit M3-Bezeichnungen müssen Sie den @scope-Parameter angeben, um Team Foundation darüber zu informieren, welche M3-Bezeichnung Sie verwenden möchten.
Sie können das "Überladen" einer Bezeichnung wie "M3" durch andere Benutzer in anderen Bereichen des Servers für die Quellcodeverwaltung in Team Foundation verhindern, indem Sie die Bezeichnung im Stamm ($/) des Servers für die Quellcodeverwaltung in Team Foundation erstellen oder die Bezeichnungsberechtigungen für bestimmte Ordner anpassen.
Verwenden der Option /Child zur Fehlervermeidung bei Bezeichnungen
Wenn Sie den Befehl label mit einem vorhandenen Bezeichnungsnamen und einem itemspec verwenden, das bereits mit der gleichen Bezeichnung markierte Dateien einschließt, gibt der Wert der Option /child an, ob die markierten Dateien mit den neuen Revisionsinformationen aktualisiert wurden. Das heißt, die Dateien werden mit dem gleichen Namen gekennzeichnet, haben jedoch unterschiedliche Bereiche.
Angenommen, der Ordner c:\projects enthält die beiden Dateien 314.cs und 271.cs. Des Weiteren hat die Version C70 von 314.cs die Bezeichnung "ready". Die aktuelle Version von 314.cs ist C93. Wenn Sie, unter Verwendung des folgenden Befehls, eine Bezeichnung "ready" auf die aktuelle Ordnerversion und die darin enthaltenen Dateien anwenden, wird die Bezeichnung "ready" von 314.cs;C70 nach 314.cs;C93 verschoben:
tf label ready c:\projects /recursive /version:T /child:Replace
Wenn Sie die vorhandene Bezeichnung "ready" jedoch nicht von Version C70 nach Version C93 von 314.cs verschieben möchten, verwenden Sie folgende Syntax:
tf label ready c:\projects /recursive /version:T /child:Merge
Wenn Sie Merge als Wert für die Option /child angeben, werden vorhandene Instanzen der bereitgestellten Bezeichnung unverändert belassen.
Hinweis
T steht für "Tip", zum Abrufen der aktuellen Version von versionspec in den zwei oben erwähnten Beispielen.
Beispiele
Im folgenden Beispiel wird die Bezeichnung "goodbuild" an die Arbeitsbereichsversion des Ordners "docs" sowie die darin enthaltenen Dateien und Ordner angefügt.
c:\projects>tf label goodbuild docs /recursive
Im folgenden Beispiel wird die Bezeichnung "goodbuild" an den Ordner "docs" angefügt, aber nicht an die darin enthaltenen Dateien und Ordner.
c:\projects>tf label goodbuild docs
Im folgenden Beispiel wird die Bezeichnung "goodbuild" auf dem Server für die Quellcodeverwaltung in Team Foundation an Version 3 von 314.cs angefügt.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
Im folgenden Beispiel wird die Bezeichnung "badbuild" aus allen Elementen auf dem Server für die Quellcodeverwaltung in Team Foundationentfernt.
c:\projects>tf label /delete badbuild
Im folgenden Beispiel wird die Option scope verwendet, um eine Bezeichnung an 314.cs anzufügen.
c:\projects>tf label goodbuild@$/TeamProject1 314.cs
Sicherheit
Zum Verwenden des label-Befehls muss die Berechtigung Bezeichnung auf Zulassen festgelegt sein. Um Bezeichnungen, die von anderen Benutzern erstellt wurden, zu ändern oder zu löschen, muss die Berechtigung Bezeichnungen verwalten auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Erweiterte Funktionalität der Quellcodeverwaltung
Gewusst wie: Anwenden von Bezeichnungen
Referenz
Befehlszeilensyntax
Befehl Labels
Befehl Unlabel
Konzepte
Sicherheitsrechte und Berechtigungen für die Quellcodeverwaltung
Arbeiten mit Bezeichnungen