Befehl Branch
Mit dem Befehl branch können Sie ein Element oder einen Satz von Elementen samt der Metadaten und dem Versionskontrollverlauf zwischen Speicherorten auf dem Server für Team Foundation-Versionskontrolle und dem lokalen Arbeitsbereich kopieren.
Tipp
Die Ergebnisse dieses Befehls werden erst nach dem Ausführen eines Eincheckvorgangs im Server für die Team Foundation-Versionskontrolle widergespiegelt. Weitere Informationen finden Sie unter Einchecken von ausstehenden Änderungen.
Erforderliche Berechtigungen
Zum Verwenden des branch-Befehls muss die Lesen-Berechtigung für das Quellelement und die Auschecken- und Zusammenführen-Berechtigungen für den Zielordner auf Zulassen festgelegt sein. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]]
Parameter
Argument |
Beschreibungen |
|---|---|
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 als Team Foundation-Versionskontrolle-Serverordner besteht, erstellt Team Foundation in ihm die verzweigten Elemente. 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 Versionsspezifikation die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Versionskontrolle). |
comment |
Stellt einen Kommentar für die Verzweigung bereit. |
@commentfile |
Gibt den Pfad zu einer Datei auf dem Datenträger an, die den für die Verzweigung verwendeten Kommentar enthält. |
authorname |
Der vom Benutzer angegebene Wert für die /author-Option. |
username |
Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder DOMÄNE\Benutzername oder Benutzername angeben. |
Option |
Beschreibungen |
|---|---|
/version |
Die Version des Elements, bei der Sie die Verzweigung erstellen möchten. Sie können die Version durch Folgendes angeben:
Wenn keine Version angegeben wird, ermittelt Team Foundation anhand der folgenden Logik, welche Version des Elements in die neue Verzweigung kopiert werden soll:
Wenn Sie eine Datei verzweigen, deren Arbeitsbereichsversion älter als die letzte Version auf dem Server für die Team Foundation-Versionskontrolle 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:
|
/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. .gif "Hinweis") 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. |
/silent |
Impliziert /noget und gibt an, dass die Ausgabe nicht in das Eingabeaufforderungsfenster geschrieben wird, wenn Sie eine Verzweigung erstellen. |
/checkin |
Erstellt die Verzweigung für den Server und checkt diese in einem Vorgang ein. Diese Option erstellt keine ausstehenden Änderungen im lokalen Arbeitsbereich. |
/comment |
Fügt der neuen Verzweigung einen Kommentar hinzu. Diese Option wird nur mit der /checkin-Option verwendet. |
/author |
Identifiziert den Autor der neuen Verzweigung. Diese Option wird nur mit der /checkin-Option verwendet. |
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 Team Foundation-Versionskontrolle-Servers als Grundlage zum Erstellen der neuen Verzweigung.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".
Beispiele
Im folgenden Beispiel wird eine Verzweigungsdatei erstellt, die die letzte Arbeitsbereichsversion von 314.cs enthält. Diese wird mit "314_branch" bezeichnet und im aktuellen Verzeichnis auf dem Datenträger sowie im Ordner auf dem Team Foundation-Versionskontrolle-Server 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, und zwar aus dem aktuellen Ordner auf dem server für die Team Foundation-Versionskontrolle in den Ordner testdata auf dem Server für die Team Foundation-Versionskontrolle und aus dem aktuellen Verzeichnis auf dem Datenträger in den Arbeitsordner, der dem Ordner testdata auf dem Server für die Team Foundation-Versionskontrolle 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, und zwar aus dem aktuellen Ordner auf dem Server für die Team Foundation-Versionskontrolle in den Ordner testfiles_branch auf dem Server für die Team Foundation-Versionskontrolle und aus c:\testfiles in den lokalen Ordner, der dem Ordner testfiles_branch auf dem Server für die Team Foundation-Versionskontrolle zugeordnet ist.
c:\projects>tf branch C:\testfiles $/testfiles_branch
Im folgenden Beispiel wird eine Verzweigung von 314.cs erstellt, wie sie im Changeset #4 der Datei vorhanden war. Im Arbeitsordner auf dem Datenträger und auf dem Server für die Team Foundation-Versionskontrolle 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 erstellt (gemäß dem Zustand vom 12.12.03). Im Arbeitsordner auf dem Datenträger und auf dem Server für die Team Foundation-Versionskontrolle 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 Team Foundation-Versionskontrolle gespeichert, der dem aktuellen Verzeichnis zugeordnet ist.
c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch
Siehe auch
Aufgaben
Verzweigen von Ordnern und Dateien