Freigeben über


Befehl Label (Team Foundation-Versionskontrolle)

Aktualisiert: November 2007

Fügt eine Versionsbezeichnung zu einer Datei oder einem Ordner auf dem Server für die Team Foundation-Versionskontrolle hinzu bzw. entfernt diese.

Erforderliche Berechtigungen

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.

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]

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 Team Foundation-Versionskontrolle an, innerhalb dessen der Bezeichnungsname eindeutig ist. Mit diesem Parameter können Bezeichnungen oder ein Satz von Elementen mit Bezeichnungen unabhängig erstellt, verwaltet, abgerufen und gelöscht werden, wenn zwei Bezeichnungen mit demselben Namen in unterschiedlichen Bereichen des Servers für die Team Foundation-Versionskontrolle 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 zum Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Team System).

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 Versionsspezifikation die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Team System).

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

Bezeichnet 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 Changesetwerte, 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.

Eine Kombination mit der Option /delete ist nicht möglich.

/delete

Entfernt die Bezeichnung.

Hinweise

Eine Bezeichnung ist eine Markierung, die Sie an einen Satz nicht zusammenhängender Dateien und Ordner auf dem Server für die Team Foundation-Versionskontrolle anfügen können. Durch die Bezeichnung wird das Abrufen dieser Dateien in einen Arbeitsbereich für die Entwicklung oder die Erstellung vereinfacht. Daher ähnelt eine Bezeichnung einem Changeset 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.

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 label-Befehl angeben, wird die Aktualisierung auf dem Server für die Team Foundation-Versionskontrolle sofort übernommen.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".

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, deren Kommentar, dem Gültigkeitsbereich und dem 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 Dateien unter Versionskontrolle in einem anderen Bereich des Servers für die Team Foundation-Versionskontrolle hinzufügt, können Sie die Bezeichnung M3 auf Dateien unter Versionskontrolle 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 der Bezeichnung M3 müssen Sie den @scope-Parameter angeben, um Team Foundation darüber zu informieren, welche der M3-Bezeichnungen Sie verwenden möchten.

Sie können das "Überladen" einer Bezeichnung wie "M3" durch andere Benutzer in anderen Bereichen des Servers für die Team Foundation-Versionskontrolle verhindern, indem Sie die Bezeichnung im Stamm ($/) des Servers für die Team Foundation-Versionskontrolle 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 Team Foundation-Versionskontrolle an Version 3 der Datei 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 Team Foundation-Versionskontrolleentfernt.

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

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erweiterte Funktionalität der Versionskontrolle

Gewusst wie: Anwenden von Bezeichnungen

Konzepte

Arbeiten mit Bezeichnungen

Referenz

Befehlszeilensyntax (Team System)

Befehl Labels

Befehl Unlabel

Weitere Ressourcen

Befehle des Befehlszeilendienstprogramms "Tf"