Pobierz polecenie (Kontrola wersji serwera Team Foundation)

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Polecenie Kontrola wersji serwera Team Foundation (TFVC) get pobiera lub pobiera najnowszą wersję lub określoną wersję jednego lub więcej plików lub folderów z usługi Azure DevOps Server do obszaru roboczego. Polecenie tf get udostępnia inny interfejs użytkownika niż program Visual Studio, ale proces jest zasadniczo taki sam. Aby uzyskać więcej informacji na temat pobierania plików i folderów przy użyciu programu Visual Studio, zobacz Pobieranie (pobieranie) plików z serwera.

Wymagania wstępne

Zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

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

Parametry

Parametr

Opis

/all

Tej opcji można użyć do przywrócenia elementu, który został przypadkowo usunięty z obszaru roboczego serwera. Jeśli używasz lokalnego obszaru roboczego, co jest zalecane, jest mało prawdopodobne, że trzeba będzie użyć tej opcji.

Serwer TFVC przechowuje wewnętrzny rekord wszystkich elementów, które zawiera obszar roboczy, w tym wersję każdego z nich. Domyślnie po pobraniu plików, jeśli wewnętrzny rekord na serwerze wskazuje, że obszar roboczy ma już pobieraną wersję, nie pobiera elementu. Ta opcja pobiera wszystkie elementy niezależnie od danych, które zawiera rekord wewnętrzny.

/force

Łączy /all i /overwrite.

<itemspec>

Określa zakres elementów do pobrania. Można określić więcej niż jeden itemspec argument. Jeśli nie itemspec zostanie podany, system rekursywnie pobiera wszystkie elementy w bieżącym obszarze roboczym.

Aby uzyskać informacje o składni, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

/login <username>,[<password>]

Określa konto użytkownika, aby uruchomić polecenie. Zobacz Używanie poleceń kontroli wersji programu Team Foundation.

/noautoresolve

Domyślnie system automatycznie podejmuje próbę autowywiązania wszystkich konfliktów. Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów Kontrola wersji serwera Team Foundation. Określ tę opcję, aby wyłączyć to zachowanie domyślne.

/noprompt

Pomija wyświetlanie okien i okien dialogowych programu Visual Studio oraz przekierowuje dane wyjściowe do wiersza polecenia. Zobacz Używanie poleceń kontroli wersji programu Team Foundation.

/overwrite

Domyślnie system nie pobiera elementu, jeśli jest zapisywalny, jest to atrybut tylko do odczytu jest czyszczone na komputerze klienckim. Ta opcja zastępuje zachowanie domyślne i zastępuje zapisywalny element, chyba że element jest wyewidencjonowany. Jeśli używasz lokalnego obszaru roboczego zgodnie z zaleceniami, prawdopodobnie konieczne będzie użycie tej opcji.

/preview

Wyświetla, co by się zdarzyło, bez faktycznego get wykonania operacji.

/recursive

Cyklicznie pobiera elementy w określonym katalogu i wszystkich podkatalogach. Jeśli nie określisz itemspecelementu , ta opcja jest dorozumiana.

/remap

Zobacz blog phkelley: tf get /remap.

/version:<versionspec>

Określa maksymalną wersję lub minimalną i maksymalną wersję do wyświetlenia w danych historii. Wartość domyślna to /version:T, najnowsza wersja.

Aby uzyskać informacje o składni, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Uwagi

  • Jeśli rozpoczynasz nowe zadanie, prawdopodobnie dobrym pomysłem jest uruchomienie tf get polecenia w celu pobrania najnowszych plików z serwera przed wyewidencjonowywaniem plików i rozpoczęciem pracy. Możesz uruchomić tf get polecenie z dowolnego folderu w obszarze roboczym.

  • W razie potrzeby tworzy foldery na dysku, tf get aby zawierały elementy podrzędne pobrane przez polecenie.

  • Informacje o historii elementu można wyświetlić za pomocą polecenia Historia i polecenia Zestaw zmian.

  • Jeśli obawiasz się, jakie zmiany mogą wystąpić w plikach w obszarze roboczym, możesz użyć /preview opcji , aby zobaczyć zmiany, które wystąpią bez ich faktycznego zaimplementowania.

  • Konflikty mogą blokować obiekt get. Typową przyczyną konfliktów jest próba pobrania elementu, na którym masz oczekujące zmiany. Aby rozwiązać te konflikty, możesz użyć polecenia Rozwiąż.

Przykłady

W poniższych przykładach przyjęto założenie, że $/SiteApp/Main/ mapuje się na c:\code\SiteApp\Main\ obszar roboczy.

Pobieranie najnowszej wersji wszystkich elementów w obszarze roboczym

Domyślnie tf get polecenie pobiera najnowsze wersje wszystkich elementów w obszarze roboczym. Na przykład następujące polecenie rekursywnie pobiera wszystkie pliki w pliku , w $/SiteApp/Main/tym wszystkie foldery podrzędne.

c:\code\SiteApp\Main>tf get

Rekursywnie pobierz najnowszą wersję elementów określonego typu w folderze

Poniższy przykład pobiera najnowszą wersję wszystkich plików C# w folderze c:\code\SiteApp\Main\SolutionA\Project1.

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

Pobieranie najnowszej wersji pliku

Poniższy przykład pobiera najnowszą wersję program.cs w programie Project1.

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

Pobieranie określonej wersji pliku

Poniższy przykład pobiera wersję 8 program.cs w programie Project1.

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

Pobieranie najnowszej wersji dwóch plików

Poniższy przykład pobiera najnowsze wersje file1.cs i file2.cs w programie Project1.

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

Synchronizowanie obszaru roboczego w celu dopasowania do wersji bazy kodu zespołu

Poniższy przykład synchronizuje obszar roboczy, aby był zgodny z bazą kodu, ponieważ istniał podczas tworzenia zestawu zmian 15:

c:\code\SiteApp\Main>tf get /v:15
  • Nazwa i zawartość każdego elementu w obszarze roboczym są zmieniane tak, aby były zgodne ze stanem, w jaki znajdował się na serwerze.
  • Elementy usunięte po tym zestawie zmian zostaną przywrócone do obszaru roboczego.
  • Elementy dodane po tym zestawie zmian zostaną usunięte z obszaru roboczego.

Synchronizowanie obszaru roboczego w celu dopasowania do oznaczonej wersji bazy kodu zespołu

Poniższy przykład synchronizuje obszar roboczy, aby był zgodny z elementami w bazie kodu, które są oznaczone etykietąLastKnownGood:

c:\code\SiteApp\Main>tf get /v:LLastKnownGood
  • Nazwa i zawartość każdego oznaczonego elementu w obszarze roboczym jest zmieniana tak, aby była zgodna ze stanem, w jaki znajdował się na serwerze.
  • Usunięte elementy z etykietami są przywracane do obszaru roboczego.
  • Elementy, które nie są oznaczone na serwerze, są usuwane z obszaru roboczego.