Freigeben über


Befehl Branch

Aktualisiert: November 2007

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.

Hinweis:

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 Gewusst wie: Einchecken von ausstehenden Änderungen.

Erforderliche Berechtigungen

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.

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:none|checkin|checkout] [/checkin] [/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 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 (Team System).

Option

Beschreibung

/version

Die Version des Elements, bei der Sie die Verzweigung erstellen möchten. Sie können die Version durch Folgendes angeben:

  • Datum/Uhrzeit (D10/20/2005)

  • Changesetnummer (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 Team Foundation-Versionskontrolle-Serverpfad festgelegt ist, verzweigt Team Foundation das Element an der aktuellen Team Foundation-Versionskontrolle-Serverversion. 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 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:

  • None

    Standard. Es wird keine Sperre angewendet. Wenn die angegebene Datei, für die Sie eine Verzweigung erstellen, 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.

/checkin

Nur mit der Service Pack 1-Version von Microsoft Visual Studio Team System 2008 Team Foundation Server zu verwenden.

Checkt die Verzweigungsaktion ein, während die Verzweigung erstellt wird.

/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 Team Foundation-Versionskontrolle-Servers als Grundlage zum Erstellen der neuen Verzweigung.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "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 von deren Zustand am 12.12.03 erstellt. 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

Exemplarische Vorgehensweise: Erweiterte Funktionalität der Versionskontrolle

Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Versionskontrolle über die Befehlszeile

Gewusst wie: Verzweigen von Dateien und Ordnern

Konzepte

Grundlagen von Verzweigungen

Arbeiten mit Changesets der Versionskontrolle

Referenz

Befehl Branches

Befehl Merge

Weitere Ressourcen

Befehle des Befehlszeilendienstprogramms "Tf"