Befehl Branch

Mit dem branch-Befehl können Sie ein Element oder einen Satz von Elementen, inklusive der Metadaten und der Versionsgeschichte der Quellcodeverwaltung, zwischen Speicherorten auf dem Quellcodeverwaltung in Team Foundation-Server und dem lokalen Arbeitsbereich kopieren.

Hinweis

Die Ergebnisse dieses Befehls werden erst nach dem Ausführen eines Eincheckvorgangs im Server für die Quellcodeverwaltung in Team Foundation widergespiegelt. Weitere Informationen finden Sie unter Gewusst wie: Einchecken von ausstehenden Änderungen.

tf branch olditem newitem [/version:versionspec] [/noget] 
[/lock] [/noprompt]

Parameter

Argument	Beschreibung
olditem	Gibt den Namen der Quelldatei oder des Quellordners an, die bzw. der verzweigt wird. olditem darf auch Versionsinformationen im Format item;version enthalten.
newitem	Gibt den Namen der Zieldatei oder des Zielordners bzw. den übergeordneten Ordner für das Ziel an. Wenn newitem bereits vorhanden und ein Ordner auf dem Server für die Quellcodeverwaltung in Team Foundation ist, erstellt Team Foundation die verzweigten Elemente in diesem. Andernfalls gibt newitem den Namen der Zieldatei oder des Zielordners an. Während des Eincheckens können Konflikte auftreten, wenn das Ziel bereits vorhanden ist.
versionspec	Gibt einen Wert für die /version-Option an. 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.

Option	Beschreibung
/version	Die Version des Elements, bei der Sie die Verzweigung erstellen möchten. Sie können die Version durch Folgendes angeben: Versionsnummer Datum/Uhrzeit (D10/20/2005) Differenzmengennummer (C1256) Bezeichnung (LBezeichnung) Letzte Version (T) Arbeitsbereich (WArbeitsbereichsname) Wenn keine Version angegeben wird, ermittelt Team Foundation anhand der folgenden Logik, welche Version des Elements in die neue Verzweigung kopiert werden soll: Wenn ein Serverpfad für die Quellcodeverwaltung in Team Foundation angegeben wird, verzweigt Team Foundation das Element an der aktuellen Version auf dem Server für die Quellcodeverwaltung in Team Foundation. Bei tf branch $/projects/help.cs wird z. B. die Serverversion verwendet. Wenn als Quelle ein lokaler Pfad angegeben wird, verwendet Team Foundation die lokale Arbeitsbereichsversion zum Erstellen der neuen Verzweigung. Bei tf branch C:\314.cs wird z. B. die lokale Arbeitsbereichsversion verwendet. Wenn Sie eine Datei verzweigen, deren Arbeitsbereichsversion älter als die letzte Version auf dem Server für die Quellcodeverwaltung in Team Foundation ist, wird die Datei an der älteren Version verzweigt.
/lock	Verhindert das Ein- bzw. Auschecken von Elementen durch andere Benutzer, bis Sie Ihre ausstehende Verzweigung und die zugehörigen Änderungen eingecheckt haben. Weitere Informationen finden Sie unter Grundlagen von Sperrentypen. Sperroptionen: None Standard. Es wird keine Sperre angewendet. Wenn die angegebene Datei gesperrt ist, kann die Sperre mit dieser Option aufgehoben werden. Checkin Andere Benutzer können die angegebenen Elemente auschecken, können Überarbeitungen gesperrter Dateien jedoch erst dann einchecken, wenn Sie die Sperre durch Einchecken wieder freigeben. Wenn eines oder mehrere der angegebenen Elemente durch einen anderen Benutzer gesperrt sind, ist der Sperrvorgang nicht möglich. Checkout Verhindert das Auschecken der angegebenen Elemente durch Benutzer, bis Sie die Sperre durch das Einchecken aufheben. Wenn andere Benutzer eines der Elemente gesperrt haben, schlägt der Sperrvorgang fehl.
/noget	Bei Angabe dieser Option werden lokale Kopien der Dateien und Ordner in der neuen Verzweigung nicht im lokalen Arbeitsbereich erstellt. Die lokalen Kopien werden aber in den Arbeitsbereich übernommen, wenn Sie das nächste Mal einen rekursiven Abrufvorgang durchführen. Hinweis Sie können verhindern, dass Elemente wie der Inhalt des Ordners /images während rekursiver Abrufvorgänge oder bei Vorgängen zum Abrufen der letzten Version abgerufen werden, indem Sie einen Arbeitsbereichsordner verdecken. Weitere Informationen finden Sie unter Befehl Workfold.
/noprompt	Unterdrückt alle Eingabeaufforderungen.

Hinweise

Wenn Sie einen lokalen Pfad wie c:\00101 angeben, jedoch keine versionspec, verwendet Team Foundation die lokale Arbeitsbereichsversion als Grundlage zum Erstellen der neuen Verzweigung.

Wenn Sie allerdings einen Serverpfad wie $/00101/*.cs angeben, jedoch keine versionspec, verwendet Team Foundation stattdessen die letzte Version des Quellcodeverwaltung in Team Foundation-Servers als Grundlage zum Erstellen der neuen Verzweigung.

Beispiele

Im folgenden Beispiel wird eine Verzweigungsdatei erstellt, die die letzte Arbeitsbereichsversion von 314.cs enthält. Diese wird mit "314_branch" benannt und im aktuellen Verzeichnis auf dem Datenträger sowie zusätzlich im Ordner auf dem Server für die Quellcodeverwaltung in Team Foundation gespeichert, der diesem Verzeichnis zugeordnet ist.

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

Im folgenden Beispiel werden sämtliche Dateien ohne ausstehende Bearbeitungsvorgänge der Arbeitsbereichsversion von 314.cs kopiert: a) aus dem aktuellen Ordner auf dem Quellcodeverwaltung in Team Foundation-Server in den Ordner testdata auf dem Quellcodeverwaltung in Team Foundation-Server und b) aus dem aktuellen Verzeichnis auf dem Datenträger in den Arbeitsordner, der dem Ordner testdata auf dem Quellcodeverwaltung in Team Foundation-Server zugeordnet ist.

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

Im folgenden Beispiel werden sämtliche Dateien ohne ausstehende Bearbeitungsvorgänge der aktuellen Arbeitsbereichsversion des Ordners testfiles sowie die enthaltenen Dateien aller Elemente kopiert: a) aus dem aktuellen Ordner auf dem Quellcodeverwaltung in Team Foundation-Server in den Ordner testfiles_branch auf dem Quellcodeverwaltung in Team Foundation-Server und b) aus c:\testfiles in den lokalen Ordner, der dem Ordner testfiles_branch auf dem Quellcodeverwaltung in Team Foundation-Server zugeordnet ist.

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

Im folgenden Beispiel wird eine Verzweigung von 314.cs erstellt, wie sie in der Differenzmenge #4 der Datei vorhanden war. Im Arbeitsordner auf dem Datenträger und auf dem Server für die Quellcodeverwaltung in Team Foundation wird die Verzweigungsdatei csharp_branch erstellt.

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

Im folgenden Beispiel wird eine neue Verzweigung von 314.cs von deren Zustand am 12.12.03 erstellt. Im Arbeitsordner auf dem Datenträger und auf dem Server für die Quellcodeverwaltung in Team Foundation wird die Verzweigungsdatei 314_branch erstellt.

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

Im folgenden Beispiel wird eine Verzweigung der Version von 314.cs erstellt, die mit "Beta1" bezeichnet wurde. Sie wird mit "Beta1branch" bezeichnet und im aktuellen Verzeichnis auf dem Datenträger und in dem Ordner auf dem Server für die Quellcodeverwaltung in Team Foundation gespeichert, der dem aktuellen Verzeichnis zugeordnet ist.

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

Sicherheit

Zum Verwenden des branch-Befehls muss die Lesen-Berechtigung für das Quellelement und die Auschecken-Berechtigung für den Zielordner auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erweiterte Funktionalität der Quellcodeverwaltung
Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile
Gewusst wie: Verzweigen von Dateien und Ordnern

Referenz

Befehl Branches
Befehl Merge

Konzepte

Sicherheitsrechte und Berechtigungen für die Quellcodeverwaltung
Grundlagen von Verzweigungen
Arbeiten mit Differenzmengen der Quellcodeverwaltung

Weitere Ressourcen

Befehle des Befehlszeilendienstprogramms "Tf"