Share via

Příkaz Branch (Správa verzí Team Foundation)

  • Článek

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

Visual Studio 2019 | Visual Studio 2022

Příkaz TFVC branch zkopíruje položku nebo sadu položek, včetně metadat a historie správy verzí, z jednoho umístění do jiného na serveru Azure DevOps a v místním pracovním prostoru.

Poznámka:

Výsledky tohoto příkazu se neprojeví na serveru Azure DevOps, dokud neprovedete operaci vrácení se změnami. Další informace najdete v tématu Vrácení práce do základu kódu týmu.

Požadavky

Chcete-li použít branch příkaz, musíte mít oprávnění ke čtení pro zdrojová položka a oprávnění Rezervovat a Sloučit pro cílovou složku nastavenou na Povolit. Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]

Parametry

Argument

Argument Popis
<olditem> Určuje název zdrojového souboru nebo složky, která se větví. Informace <olditem> o verzi mohou obsahovat také ve formátu item;version.
<newitem> Určuje název cílového souboru nebo složky nebo nadřazené složky cíle. Pokud <*newitem> už existuje a je to složka Azure DevOps Serveru, TFVC vytvoří v ní větvené položky. <newitem> V opačném případě určuje název cílového souboru nebo složky. Konflikty můžou nastat při vrácení se změnami, pokud cíl již existuje.
<versionspec> Poskytuje hodnotu pro možnost /version . Další informace o tom, jak TFVC parsuje specifikaci verze k určení položek v rámci oboru, naleznete v tématu Použití příkazů správy verzí Team Foundation.
<comment> Poskytuje komentář k větvi.
@<commentfile> Určuje cestu k souboru, který obsahuje komentář, který se používá pro větev.
<authorname> Hodnota zadaná uživatelem pro možnost /author .
<username> Poskytuje hodnotu možnosti /login . Hodnotu uživatelského jména můžete zadat buď nebo DOMAIN\username<username>.

Možnost

Možnost

Popis

/version

Verze položky, ve které chcete vytvořit větev. Verzi můžete zadat pomocí:

  • Datum a čas (D10/20/2005)
  • Číslo sady změn (C1256)
  • Popisek (Lmylabel)
  • Nejnovější verze (T)
  • Pracovní prostor (Wworkspacename)

Pokud není k dispozici žádná verze, TFVC použije následující logiku k rozhodnutí, která verze položky se má zkopírovat do nové větve:

  • Pokud je zadána cesta k Serveru Azure DevOps, TFVC vytvoří větev položky na nejnovější verzi Azure DevOps Serveru. tf branch $/projects/help.cs Například používá verzi serveru.
  • Pokud je pro zdroj zadána místní cesta, TFVC použije k vytvoření nové větve místní verzi pracovního prostoru. tf branch C:\314.cs Například používá místní verzi pracovního prostoru.

Pokud vytvoříte větev souboru, jehož verze pracovního prostoru je starší než nejnovější verze na serveru Azure DevOps, bude soubor větvený ve starší verzi.

/lock

Zabrání ostatním uživatelům vrátit se změnami nebo rezervovat položky, dokud nezaškrtnete čekající větev a související změny. Další informace naleznete v tématu Principy typů zámků.

Možnosti uzamčení:

  • none
    Výchozí. Není použit žádný zámek. Pokud v souboru, pro který vytváříte větev, existuje zámek, odebere se tato možnost.
  • checkin
    Ostatní uživatelé si můžou rezervovat zadané položky, ale nemůžou vrátit revize uzamčených souborů, dokud zámek neuvolníte provedením vrácení se změnami. Pokud někdo jiný uživatel zamkl některou ze zadaných položek, operace uzamčení selže.
  • checkout
    Zabrání ostatním uživatelům v vrácení se změnami nebo rezervaci některé ze zadaných položek, dokud zámek neuvolníte provedením vrácení se změnami. Pokud někdo jiný uživatel zamkl některou ze zadaných položek, operace uzamčení selže.

/noget

Pokud je tato možnost zadaná, místní kopie souborů a složek v nové větvi se v místním pracovním prostoru nevytvořily. Při příštím provedení rekurzivní operace get se však místní kopie načtou do pracovního prostoru.

Poznámka:

Během rekurzivního získání a získání nejnovějších operací můžete zabránit načtení položek, jako je například obsah složky /images , do pracovního prostoru. Další informace naleznete v části Příkaz Workfold.

/noprompt

Potlačí všechny výzvy k zadání vstupu od vás.

/silent

Implikuje /nogeta určuje, že výstup není zapsán do okna příkazového řádku při vytváření větve.

/checkin

Vytvoří a zkontroluje větev na server v jedné operaci. Tato možnost nevytvoří žádné čekající změny v místním pracovním prostoru.

/comment

Přidá do nové větve komentář. Tato možnost se používá pouze s /checkin touto možností.

/author

Identifikuje autora nové větve. Tato možnost se používá pouze s /checkin touto možností.

/recursive

U složek rozvětvte všechny soubory i uvnitř.

Poznámky

Pokud zadáte místní cestu, například c:\00101, ale nezadáte ji <versionspec>, tfVC jako základ pro vytvoření nové větve použije místní verzi pracovního prostoru.

Pokud ale zadáte cestu k serveru, například $/00101/*.cs a nezadáte <versionspec>ji, TFVC použije jako základ pro vytvoření nové větve nejnovější verzi Azure DevOps Serveru.

Další informace o tom, jak používat nástroj příkazového tf řádku, naleznete v tématu Použití příkazů správy verzí Team Foundation.

Příklady

Následující příklady předpokládají, že se c:\projects mapuje na hlavní složku v pracovním prostoru.

Následující příklad vytvoří soubor větve, který obsahuje nejnovější verzi pracovního prostoru 314.cs, pojmenuje ho 314_branch a uloží ho do aktuálního adresáře na disku a také do složky Azure DevOps Serveru, na kterou se mapuje.

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

Následující příklad zkopíruje všechny soubory bez čekajících úprav ve verzi pracovního prostoru 314.cs z aktuální složky Azure DevOps Serveru do složky testdata Azure DevOps Serveru a z aktuálního adresáře na disku do pracovní složky, která se mapuje do složky testdata Azure DevOps Serveru.

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

Následující příklad zkopíruje všechny soubory bez čekajících úprav v aktuální verzi pracovního prostoru složky testfiles a soubory, které obsahuje pro všechny položky z aktuální složky Azure DevOps Serveru, do složky testfiles_branch Azure DevOps Server a ze složky c:\testfiles do místní složky, která se mapuje na složku testfiles_branch Azure DevOps Server.

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

Následující příklad vytvoří větev 314.cs , protože existovala v sadě změn č. 4 souboru. V pracovní složce na disku, jako na serveru Azure DevOps, se vytvoří soubor větve s názvem csharp_branch .

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

Následující příklad vytvoří novou větev 314.cs tak, jak byla 12.12.03. V pracovní složce na disku jako na serveru Azure DevOps se vytvoří soubor větve s názvem 314\branch .

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

Následující příklad větví verzi 314.cs , na kterou Beta1 byl popisek použit, pojmenuje ho Beta1branch a uloží ho do aktuálního adresáře na disku a kromě složky Azure DevOps Serveru, do které se aktuální adresář mapuje.

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