Freigeben über

Branch-Befehl (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022-

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

Anmerkung

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

Voraussetzungen

Um den Befehl branch zu verwenden, verfügen Sie über die Berechtigung Lesen für das Quellelement, und die Auschecken und Berechtigungen für den Zielordner auf Allowfestgelegt. 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, die verzweigt wird. Die <olditem> können 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 ist und ein Azure DevOps Server-Ordner ist, erstellt TFVC die verzweigten Elemente darin. Andernfalls gibt <newitem> den Namen der Zieldatei oder des Zielordners an. Konflikte können beim Einchecken auftreten, wenn das Ziel bereits vorhanden ist.
<versionspec> Stellt einen Wert für die Option /version bereit. Weitere Informationen dazu, wie TFVC eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente in ihrem Bereich enthalten sind, finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version.
<comment> Stellt einen Kommentar zu der Verzweigung bereit.
@<commentfile> Gibt den Pfad einer Datei an, die den Kommentar enthält, der für die Verzweigung 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 entweder als DOMAIN\username oder als <username>angeben.

Option

Option

Beschreibung

/version

Die Version des Elements, bei dem Sie die Verzweigung erstellen möchten. Sie können eine Version angeben, indem Sie:

  • Datum/Uhrzeit (D10/20/2005)
  • Changeset-Nummer (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 die neue Verzweigung kopiert werden soll:

  • Wenn ein Azure DevOps Server-Pfad angegeben ist, verzweigt TFVC das Element mit der neuesten Azure DevOps Server-Version. Beispielsweise verwendet tf branch $/projects/help.cs die Serverversion.
  • Wenn für die Quelle ein lokaler Pfad angegeben ist, verwendet TFVC die lokale Arbeitsbereichsversion, um die neue Verzweigung zu erstellen. Beispielsweise verwendet 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 an der älteren Version verzweigt.

/lock

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

Sperroptionen:

  • none
    Vorgabe. Es wird keine Sperre angewendet. Wenn eine Sperre für die Datei vorhanden ist, für die Sie eine Verzweigung erstellen, wird diese Option entfernt.
  • checkin
    Andere Benutzer können die angegebenen Elemente auschecken, aber sie können keine Überarbeitungen für gesperrte Dateien einchecken, bis Sie die Sperre freigeben, indem Sie ein Einchecken durchführen. 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 freigeben, indem Sie ein Einchecken durchführen. 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 in der neuen Verzweigung nicht im lokalen Arbeitsbereich erstellt. Lokale Kopien werden jedoch beim nächsten Ausführen eines rekursiven Get-Vorgangs in den Arbeitsbereich abgerufen.

Anmerkung

Sie können verhindern, dass Elemente, z. B. der Inhalt eines /images Ordners, während rekursivem Abrufen und Abrufen der neuesten Vorgänge in Ihren Arbeitsbereich abgerufen werden, indem Sie einen Arbeitsbereichsordner verschließen. Weitere Informationen finden Sie unter Workfold Command.

/noprompt

Unterdrückt alle Aufforderungen zur Eingabe von Ihnen.

/silent

Impliziert /nogetund gibt an, dass die Ausgabe beim Erstellen einer Verzweigung nicht in das Eingabeaufforderungsfenster geschrieben wird.

/checkin

Erstellt und überprüft die Verzweigung auf dem Server in einem Einzigen 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 der neuen Verzweigung. Diese Option wird nur mit der Option /checkin verwendet.

/recursive

Verzweigen Sie bei Ordnern auch alle Dateien innerhalb.

Bemerkungen

Wenn Sie einen lokalen Pfad wie c:\00101 angeben, aber keine <versionspec>angeben, verwendet TFVC die lokale Arbeitsbereichsversion als Grundlage zum Erstellen der neuen Verzweigung.

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

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Beispiele

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

Im folgenden Beispiel wird eine Verzweigungsdatei erstellt, die die neueste Arbeitsbereichsversion von 314.csenthält, benannt sie 314_branchund speichert sie im aktuellen Verzeichnis auf dem Datenträger und auch 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 Azure DevOps Server-Ordner in den Testdatenordner Azure DevOps Server-Ordner und aus dem aktuellen Verzeichnis auf dem Datenträger in den Arbeitsordner kopiert, der dem Testdaten Azure DevOps Server-Ordner zugeordnet ist.

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

Das folgende Beispiel kopiert alle Dateien ohne ausstehende Bearbeitungen in der aktuellen Arbeitsbereichsversion des Testdateien Ordners und die Dateien, die sie für alle Elemente aus dem aktuellen Azure DevOps Server-Ordner enthält, in den Ordner testfiles_branch Azure DevOps Server und aus c:\testfiles in den lokalen Ordner, der dem Ordner testfiles_branch Azure DevOps Server zugeordnet ist.

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

Im folgenden Beispiel wird eine Verzweigung von 314.cs erstellt, wie sie in Changeset #4 für die Datei vorhanden ist. Im Arbeitsordner auf dem Datenträger, wie auf dem Azure DevOps-Server, wird eine Verzweigungsdatei mit dem Titel csharp_branch erstellt.

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

Im folgenden Beispiel wird eine neue Verzweigung von 314.cs erstellt, wie sie am 12.12.03. war. Im Arbeitsordner auf dem Datenträger wie auf dem Azure DevOps-Server wird eine Verzweigungsdatei 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 bezeichnung Beta1 angewendet wurde, benannt sie Beta1branchund speichert sie zusätzlich zum Azure DevOps Server-Ordner, dem das aktuelle Verzeichnis zugeordnet ist.

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