Branchbefehl

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | VS 2017 | VS 2015 | VS 2013

Der Branchbefehl kopiert ein Element oder eine Gruppe von Elementen, einschließlich Metadaten und Versionskontrollverlauf, von einem Speicherort an einen anderen im Team Foundation-Versionskontrollserver und im lokalen Arbeitsbereich.

Hinweis

Die Ergebnisse dieses Befehls werden erst dann auf dem Team Foundation-Versionskontrollserver widergespiegelt, wenn Sie einen Eincheckvorgang ausführen. Weitere Informationen finden Sie unter Einchecken ausstehender Änderungen.

Erforderliche Berechtigungen

Um den Branchbefehl verwenden zu können, müssen Sie über die Leseberechtigung für das Quellelement und über die Berechtigungen Auschecken und Zusammenführen für den Zielordner verfügen, die auf Zulassenfestgelegt sind. Weitere Informationen finden Sie unter Berechtigungen und Gruppenreferenz.

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]

Parameter

Argument

Argument Beschreibung
olditem Gibt den Namen der Quelldatei oder des Ordners an, die verzweigt wird. Das Olditem kann auch Versionsinformationen im Formatelement;Versionenthalten.
Newitem Gibt den Namen der Zieldatei oder des Zielordners oder des übergeordneten Ordners für das Ziel an. Wenn newitem bereits vorhanden ist und ein Team Foundation-Versionskontrollserverordner ist, erstellt Team Foundation die verzweigten Elemente darin. Andernfalls gibt newitem den Namen der Zieldatei oder des Zielordners an. Konflikte können während des Eincheckens auftreten, wenn das Ziel bereits vorhanden ist.
Versionspec Stellt einen Wert für die Option /version bereit. Weitere Informationen dazu, wie Team Foundation eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Versionskontrolle).
comment Stellt einen Kommentar zum Branch bereit.
@commentfile Gibt den Pfad einer Datei an, die den Kommentar enthält, der für den Branch verwendet wird.
authorname Der vom Benutzer bereitgestellte Wert für die Option /author.
username Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenwert als DOMAIN*UserName* oder UserNameangeben.

Option

Option

Beschreibung

/version

Die Version des Elements, an dem Sie den Branch erstellen möchten. Sie können eine Version wie folgt angeben:

  • Datum/Uhrzeit (D10/20/2005)
  • Changesetnummer (C1256)
  • Label (Lmylabel)
  • Neueste Version (T)
  • Arbeitsbereich (Wworkspacename)

Wenn keine Version angegeben wird, verwendet Team Foundation die folgende Logik, um zu entscheiden, welche Version des Elements in den neuen Branch kopiert werden soll:

  • Wenn ein Serverpfad für die Team Foundation-Versionskontrolle angegeben ist, verzweigt Team Foundation das Element mit der neuesten Version des Team Foundation-Versionskontrollservers. Beispielsweise verwendet tf branch $/projects/help.cs die Serverversion.
  • Wenn ein lokaler Pfad für die Quelle angegeben ist, verwendet Team Foundation die lokale Arbeitsbereichsversion, um den neuen Branch zu erstellen. Tf Branch C:\314.cs verwendet beispielsweise die Version des lokalen Arbeitsbereichs.

Wenn Sie eine Datei verzweigen, deren Arbeitsbereichsversion auf dem Team Foundation-Versionskontrollserver älter als die neueste Version ist, wird die Datei mit der älteren Version verzweigt.

/lock

Verhindert, dass andere Benutzer Elemente ein- oder auschecken, bis Sie ihre ausstehende Verzweigung und die zugehörigen Änderungen einchecken. Weitere Informationen finden Sie unter Grundlegendes zu Sperrtypen.

Sperroptionen:

  • None
    Standard. Es wird keine Sperre angewendet. Wenn eine Sperre für die Datei vorhanden ist, für die Sie einen Branch erstellen, wird sie mit dieser Option entfernt.
  • Checkin
    Andere Benutzer können die angegebenen Elemente auschecken, jedoch keine Revisionen in gesperrten Dateien einchecken, bis Sie die Sperre durch Ausführen eines Eincheckens freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.
  • Kasse
    Verhindert, dass andere Benutzer eines der angegebenen Elemente einchecken oder auschecken, bis Sie die Sperre durch Ausführen eines Eincheckens freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

/noget

Wenn diese Option angegeben ist, werden lokale Kopien der Dateien und Ordner im neuen Branch nicht im lokalen Arbeitsbereich erstellt. Lokale Kopien werden jedoch beim nächsten Ausführen eines rekursiven Get-Vorgangs in den Arbeitsbereich abgerufen.

Hinweis

Sie können verhindern, dass Elemente, z. B. der Inhalt eines Ordners /images, während rekursiver Get- und Get Latest-Vorgänge in Ihren Arbeitsbereich abgerufen werden, indem Sie einen Arbeitsbereichsordner ver tarnen. Weitere Informationen finden Sie unter Workfold-Befehl.

/noprompt

Unterdrückt eingabeaufforderungen von Ihnen.

/silent

Impliziert /noget und gibt an, dass die Ausgabe beim Erstellen eines Branchs nicht in das Eingabeaufforderungsfenster geschrieben wird.

/checkin

Erstellt und überprüft die Verzweigung zum Server in einem Vorgang. Mit dieser Option werden keine ausstehenden Änderungen im lokalen Arbeitsbereich erstellt.

/comment

Fügt der neuen Verzweigung einen Kommentar hinzu. Diese Option wird nur mit der Option /checkin verwendet.

/author

Identifiziert den Autor des neuen Branchs. Diese Option wird nur mit der Option /checkin verwendet.

/recursive

Bei Ordnern werden auch alle Darin enthaltenen Dateien verzweigt.

Hinweise

Wenn Sie einen lokalen Pfad wie c:\00101 angeben, aber keine Versionsspezifikationangeben, verwendet Team Foundation die lokale Arbeitsbereichsversion als Grundlage für die Erstellung des neuen Branchs.

Wenn Sie jedoch einen Serverpfad wie $/00101/*.cs angeben und keine Versionsspezifikationangeben, verwendet Team Foundation stattdessen die neueste Version des Team Foundation-Versionskontrollservers als Grundlage für die Erstellung des neuen Branchs.

Weitere Informationen zum Suchen des Befehlszeilenprogramms tf finden Sie unter Tf Command-Line-Hilfsprogrammbefehle.

Beispiele

Im folgenden Beispiel wird eine Branchdatei erstellt, die die neueste Arbeitsbereichsversion von 314.cs enthält, sie als "314_branch" benennt und sie im aktuellen Verzeichnis auf dem Datenträger sowie im Team Foundation-Versionskontrollserverordner speichert, dem sie zugeordnet ist.

c:\projects>tf branch 314.cs 314_branch

Im folgenden Beispiel werden alle Dateien ohne ausstehende Änderungen in der Arbeitsbereichsversion 314.cs aus dem aktuellen Serverordner der Team Foundation-Versionskontrolle in den Serverordner testdata Team Foundation version control und aus dem aktuellen Verzeichnis auf dem Datenträger in den Arbeitsordner kopiert, der dem Serverordner der Testdata Team Foundation-Versionskontrolle zugeordnet ist.

c:\projects>tf branch C:\314.cs $/testdata

Im folgenden Beispiel werden alle Dateien ohne ausstehende Änderungen in der aktuellen Arbeitsbereichsversion des Ordners testfiles kopiert, und die darin enthaltenen Dateien für alle Elemente aus dem aktuellen Serverordner der Team Foundation-Versionskontrolle werden in den Serverordner testfiles_branch Team Foundation-Versionskontrolle und aus c:\testfiles in den lokalen Ordner kopiert, der dem Serverordner testfiles_branch Team Foundation-Versionskontrolle zugeordnet ist.

c:\projects>tf branch C:\testfiles $/testfiles_branch

Im folgenden Beispiel wird der Branch 314.cs erstellt, wie er in Changeset 4 für die Datei vorhanden war. Im Arbeitsordner auf dem Datenträger wird wie auf dem Team Foundation-Versionskontrollserver eine Branchdatei mit dem Namen csharp_branch erstellt.

c:\projects>tf branch C:\314.cs;C4 csharp_branch

Im folgenden Beispiel wird der neue Branch 314.cs wie am 12.12.03 erstellt. Im Arbeitsordner auf dem Datenträger wie auf dem Team Foundation-Versionskontrollserver wird eine Branchdatei mit dem Namen 314_branch erstellt.

c:\projects>tf branch 314.cs;D12/12/03 314_branch

Im folgenden Beispiel wird die Version von 314.cs verzweigt, auf die die Bezeichnung "Beta1" angewendet wurde, sie heißt "Beta1branch" und speichert sie im aktuellen Verzeichnis auf dem Datenträger zusätzlich zum Team Foundation-Versionskontrollserverordner, dem das aktuelle Verzeichnis zugeordnet ist.

c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch

Weitere Informationen

Aufgaben

Branchordner und -dateien

Verweis

Branches-Befehl

Mergebefehl

Konzepte

Arbeiten mit Changesets

Weitere Ressourcen

Tf Command-Line-Hilfsprogrammbefehle