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

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

Visual Studio 2019 | Visual Studio 2022

Příkaz Správa verzí Team Foundation (TFVC) get získá nebo stáhne nejnovější verzi nebo zadanou verzi jednoho nebo více souborů nebo složek z Azure DevOps Serveru do pracovního prostoru. Příkaz tf get poskytuje jiné uživatelské rozhraní než Visual Studio, ale proces je v podstatě stejný. Další informace o použití sady Visual Studio k získání souborů a složek naleznete v tématu Stažení (získání) souborů ze serveru.

Požadavky

Viz Výchozí oprávnění TFVC.

Syntaxe

tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]

Parametry

Parametr

Popis

/all

Tuto možnost můžete použít k obnovení položky, kterou jste omylem odstranili z pracovního prostoru serveru. Pokud používáte místní pracovní prostor, který se doporučuje, je nepravděpodobné, že tuto možnost budete muset použít.

TFVC udržuje interní záznam všech položek, které pracovní prostor obsahuje, včetně verze každého pracovního prostoru. Pokud se při získávání souborů zobrazí interní záznam na serveru, znamená to, že pracovní prostor už má verzi, kterou získáváte, nenačte položku. Tato možnost získá všechny položky bez ohledu na data, která interní záznam obsahuje.

/force

Kombinuje /all a /overwrite.

<itemspec>

Určuje rozsah položek, které se mají získat. Můžete zadat více než jeden itemspec argument. itemspec Pokud není k dispozici, systém rekurzivně získá všechny položky v aktuálním pracovním prostoru.

Syntaxi najdete v tématu Použití příkazů správy verzí Team Foundation.

/login <username>,[<password>]

Určuje uživatelský účet ke spuštění příkazu. Viz Použití příkazů správy verzí Team Foundation.

/noautoresolve

Ve výchozím nastavení se systém automaticky pokusí automaticky převést všechny konflikty. Další informace najdete v tématu Řešení konfliktů Správa verzí Team Foundation. Tuto možnost zadejte, pokud chcete toto výchozí chování zakázat.

/noprompt

Potlačí zobrazení oken a dialogových oken sady Visual Studio a přesměruje výstupní data na příkazový řádek. Viz Použití příkazů správy verzí Team Foundation.

/overwrite

Ve výchozím nastavení systém na klientském počítači nenačte položku, pokud je zapisovatelná, tj. její atribut jen pro čtení se vymaže. Tato možnost přepíše výchozí chování a přepíše zapisovatelnou položku, pokud není položka rezervována. Pokud použijete místní pracovní prostor podle doporučení, je nepravděpodobné, že tuto možnost budete muset použít.

/preview

Zobrazí, co by se stalo bez skutečného get provedení operace.

/recursive

Rekurzivně získá položky v zadaném adresáři a všech podadresářích. Pokud neurčíte itemspec, tato možnost je implicitní.

/remap

/version:<versionspec>

Určuje maximální verzi nebo minimální a maximální verze, které se mají zobrazit v datech historie. Výchozí hodnota je /version:Tnejnovější verze.

Syntaxi najdete v tématu Použití příkazů správy verzí Team Foundation.

Poznámky

  • Pokud začínáte nový úkol, je pravděpodobně vhodné spustit tf get stahování nejnovějších souborů ze serveru, než si soubory rezervujete a začnete pracovat. Můžete spouštět tf get z libovolné složky v pracovním prostoru.

  • Podle potřeby vytvoří na disku složky, tf get které budou obsahovat podřízené položky, které příkaz stáhne.

  • Informace o historii položky můžete zobrazit pomocí příkazu Historie a příkazu Sady změn.

  • Pokud máte obavy, k jakým změnám může docházet u souborů v pracovním prostoru, můžete pomocí /preview této možnosti zobrazit změny, ke kterým by došlo, aniž byste je skutečně implementovali.

  • Konflikty by mohly blokovat vaše get. Typickým důvodem konfliktů je pokus o získání položky, na které čekáte na změny. K vyřešení těchto konfliktů můžete použít příkaz Vyřešit.

Příklady

Následující příklady předpokládají, že se $/SiteApp/Main/ mapuje na c:\code\SiteApp\Main\ pracovní prostor.

Získání nejnovější verze všech položek v pracovním prostoru

Ve výchozím nastavení příkaz tf get získá nejnovější verze všech položek v pracovním prostoru. Například následující příkaz rekurzivně získá všechny soubory , $/SiteApp/Main/včetně všech jeho podřízených složek.

c:\code\SiteApp\Main>tf get

Rekurzivní získání nejnovější verze položek určitého typu ve složce

Následující příklad získá nejnovější verzi všech souborů C# v c:\code\SiteApp\Main\SolutionA\Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive

Získání nejnovější verze souboru

Následující příklad získá nejnovější verzi program.cs v Projectu1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs

Získání konkrétní verze souboru

Následující příklad získá verzi 8 program.cs v Projectu1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8

Získání nejnovější verze dvou souborů

Následující příklad získá nejnovější verze file1.cs a file2.cs v Projectu1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs

Synchronizace pracovního prostoru tak, aby odpovídala verzi základu kódu týmu

Následující příklad synchronizuje pracovní prostor tak, aby odpovídal základu kódu, jak existoval při vytvoření sady změn 15:

c:\code\SiteApp\Main>tf get /v:15
  • Název a obsah každé položky v pracovním prostoru se změní tak, aby odpovídal stavu, ve který byl na serveru.
  • Položky odstraněné po této sadě změn se obnoví do pracovního prostoru.
  • Položky přidané po této sadě změn se z pracovního prostoru odstraní.

Synchronizace pracovního prostoru tak, aby odpovídala označené verzi základu kódu týmu

Následující příklad synchronizuje pracovní prostor tak, aby odpovídal položkám v základu kódu, které jsou označené jakoLastKnownGood:

c:\code\SiteApp\Main>tf get /v:LLastKnownGood
  • Název a obsah každé označené položky v pracovním prostoru se změní tak, aby odpovídal stavu, ve který byl na serveru.
  • Odstraněné položky s popiskem se obnoví do pracovního prostoru.
  • Položky, které nejsou na serveru označené, se z pracovního prostoru odstraní.