Branchbefehl (Team Foundation-Versionskontrolle)

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

Der TFVC-Befehl branch kopiert ein Element oder eine Gruppe von Elementen, einschließlich Metadaten und Versionsverwaltungsverlauf, von einem Speicherort auf dem Azure DevOps-Server und im lokalen Arbeitsbereich.

Hinweis

Die Ergebnisse dieses Befehls werden erst auf dem Azure DevOps-Server widergespiegelt, wenn Sie einen Eincheckvorgang ausführen. Weitere Informationen finden Sie unter Einchecken Ihrer Arbeit in der Codebasis des Teams.

Voraussetzungen

Um den branch Befehl verwenden zu können, müssen Sie über die Berechtigung Lesen für das Quellelement und die Berechtigungen Auschecken und Zusammenführen für den Zielordner auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

Syntax

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, der verzweigt wird. Die <olditem> kann auch Versionsinformationen im Format item;versionenthalten.
<newitem> Gibt den Namen der Zieldatei oder des Zielordners oder des übergeordneten Ordners für das Ziel an. Wenn <*newitem> bereits vorhanden und ein Azure DevOps Server Ordner ist, erstellt TFVC die verzweigten Elemente darin. <newitem> Gibt andernfalls den Namen der Zieldatei oder des Zielordners an. Während des Eincheckens können Konflikte auftreten, wenn das Ziel bereits vorhanden ist.
<versionspec> Stellt einen Wert für die Option bereit /version . Weitere Informationen dazu, wie TFVC eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente in ihrem Bereich liegen, finden Sie unter Verwenden von Team Foundation-Versionssteuerungsbefehlen.
<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 /author Option.
<username> Stellt der Option einen Wert bereit /login . Sie können einen Benutzernamenwert als oder DOMAIN\username<username>angeben.

Option

Option

Beschreibung

/version

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

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

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

  • Wenn ein Azure DevOps Server Pfad angegeben wird, verzweigt TFVC das Element mit der neuesten Azure DevOps Server Version. Verwendet beispielsweise tf branch $/projects/help.cs die Serverversion.
  • Wenn ein lokaler Pfad für die Quelle angegeben wird, verwendet TFVC die lokale Arbeitsbereichsversion, um den neuen Branch zu erstellen. Verwendet beispielsweise tf branch C:\314.cs die lokale Arbeitsbereichsversion.

Wenn Sie eine Datei verzweigen, deren Arbeitsbereichsversion älter als die neueste Version auf dem Azure DevOps-Server ist, wird die Datei in der älteren Version verzweigt.

/lock

Verhindert, dass andere Benutzer Elemente einchecken oder auschecken, bis Sie Ihren ausstehenden Branch 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 diese Option entfernt.
  • checkin
    Andere Benutzer können die angegebenen Elemente auschecken, aber sie können keine Revisionen für gesperrte Dateien einchecken, bis Sie die Sperre durch ein Einchecken freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.
  • checkout
    Verhindert, dass andere Benutzer eines der angegebenen Elemente einchecken oder auschecken, bis Sie die Sperre durch ein Einchecken freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

/noget

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

Hinweis

Sie können verhindern, dass Elemente, z. B. der Inhalt eines Ordners /images , während rekursiver Vorgänge zum Abrufen und Abrufen neuester Vorgänge in Ihren Arbeitsbereich abgerufen werden, indem Sie einen Arbeitsbereichsordner umschließen. Weitere Informationen finden Sie unter Workfold-Befehl.

/noprompt

Unterdrückt alle Eingabeaufforderungen für Eingaben 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 den Branch in einem Vorgang auf den Server. Mit dieser Option werden keine ausstehenden Änderungen im lokalen Arbeitsbereich erstellt.

/comment

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

/author

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

/recursive

Verzweigen Sie für Ordner auch alle Dateien darin.

Bemerkungen

Wenn Sie einen lokalen Pfad wie c:\00101 angeben, aber keinen angeben <versionspec>, verwendet TFVC die lokale Arbeitsbereichsversion als Grundlage für das Erstellen des neuen Branchs.

Wenn Sie jedoch einen Serverpfad wie $/00101/*.cs angeben und keinen angeben<versionspec>, verwendet TFVC stattdessen die neueste Azure DevOps Server Version als Grundlage für das Erstellen des neuen Branchs.

Weitere Informationen zur Verwendung des Befehlszeilenprogramms finden Sie unter Verwenden vontf Team Foundation-Versionssteuerungsbefehlen.

Beispiele

In den folgenden Beispielen wird davon ausgegangen, dass c:\projects dem Hauptordner im Arbeitsbereich zugeordnet wird.

Im folgenden Beispiel wird eine Branchdatei erstellt, die die neueste Arbeitsbereichsversion von 314.cs enthält, ihr den Namen 314_branch, und speichert sie im aktuellen Verzeichnis auf dem Datenträger sowie im Azure DevOps Server Ordner, dem sie zugeordnet ist.

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

Im folgenden Beispiel werden alle Dateien ohne ausstehende Bearbeitungen in der Arbeitsbereichsversion von 314.cs aus dem aktuellen ordner Azure DevOps Server in den Ordner testdata Azure DevOps Server und aus dem aktuellen Verzeichnis auf dem Datenträger in den Arbeitsordner kopiert, der den Testdaten Azure DevOps Server Ordner.

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

Im folgenden Beispiel werden alle Dateien ohne ausstehende Bearbeitungen in der aktuellen Arbeitsbereichsversion des Ordners testfiles und die darin enthaltenen Dateien für alle Elemente aus dem aktuellen ordner Azure DevOps Server in den ordner testfiles_branch Azure DevOps Server und aus c:\testfiles in den lokalen Ordner kopiert, der dem testfiles_branch Azure DevOps Server Ordner.

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

Im folgenden Beispiel wird ein Branch von 314.cs erstellt, wie er in changeset #4 für die Datei vorhanden war. Im Arbeitsordner auf dem Datenträger wird wie auf dem Azure DevOps-Server eine Branchdatei mit dem Titel csharp_branch erstellt.

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

Im folgenden Beispiel wird ein neuer Branch von 314.cs erstellt, wie er am 12.12.03 war. Im Arbeitsordner auf dem Datenträger wie auf dem Azure DevOps-Server wird eine Branchdatei mit dem Titel 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 Beta1 Bezeichnung angewendet wurde, sie als Beta1branch bezeichnet und zusätzlich zum Azure DevOps Server Ordner, dem das aktuelle Verzeichnis zugeordnet ist, im aktuellen Verzeichnis auf dem Datenträger gespeichert.

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