Udostępnij za pośrednictwem


Wyświetl polecenie (Kontrola wersji serwera Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

Polecenie Kontrola wersji serwera Team Foundation (TFVC) view pobiera określoną wersję pliku, przechowuje go w folderze tymczasowym na komputerze i wyświetla go.

Wymagania wstępne

Aby użyć view polecenia, musisz mieć uprawnienie Odczyt ustawione na Zezwalaj. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec> 
[/version:<version-spec>] [/login:<username>,[<password>]]

Parametry

W poniższych sekcjach opisano argumenty i opcje view polecenia.

Argumenty

Argument

Opis

<team-project-collection-url>

Zawiera adres URL kolekcji projektów, która zawiera określoną wersję pliku, o którym chcesz pobrać informacje, na przykład https://myserver:8080/tfs/DefaultCollection.

<shelveset-name> [:<owner>]

Identyfikuje zestaw na półce. Opcjonalny <owner> argument służy do określania zestawu na półce, który nie jest własnością bieżącego użytkownika.

<item-spec>

Identyfikuje plik lub folder do pobrania. Aby uzyskać więcej informacji na temat analizowania argumentu <item-spec> przez funkcję TFVC w celu określenia, które elementy znajdują się w zakresie, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation — używanie opcji do modyfikowania sposobu działania poleceń).

Uwaga

Można określić więcej niż jeden <item-spec> argument.

<version-spec>

Udostępnia wartość, taką jak C3 dla /version opcji. Aby uzyskać więcej informacji na temat analizowania specyfikacji wersji w celu określenia, które elementy znajdują się w jego zakresie, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

<username>

Udostępnia wartość /login opcji. Tę wartość można określić jako DOMAIN\<username> lub <username>.

<password>

Udostępnia wartość /login opcji.

<local-file>

Zawiera ścieżkę do folderu pliku wyjściowego.

Opcje

Opcja

Opis

/console

Określa, że dane wyjściowe pliku powinny być kierowane do konsoli. Ta opcja jest przydatna, jeśli chcesz zapisać plik na dysku przy użyciu przekierowania konsoli, ale użyć innej nazwy lub lokalizacji niż wersja elementu.

/recursive

Wyświetla wszystkie elementy w określonym katalogu i wszystkich podkatalogach.

/shelveset

Określa zestaw na półce według nazwy.

/noprompt

Określa, że funkcja TFVC nie powinna wyświetlać monitu przed wyświetleniem każdego pliku w przypadku uwzględnienia wyrażenia wieloznacznego w argumencie zgodnym <item-spec> z więcej niż jednym plikiem.

/version

Określa wersję pliku do otwarcia do wyświetlenia. Jeśli pominiesz tę opcję, view pobierze najnowszą wersję serwera Usługi Azure DevOps.

/collection

Określa kolekcję projektów.

/login

Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika w usłudze Azure DevOps.

/output

Zwraca plik do folderu lokalnego zamiast wywoływania powłoki systemu Windows w celu otwarcia pliku.

Uwagi

Polecenie viewtf narzędzia wiersza polecenia pobiera kopię pliku tylko do odczytu z serwera Usługi Azure DevOps, przechowuje plik w folderze tymczasowym na komputerze i wyświetla jego zawartość. O ile nie określisz określonej wersji, funkcja TFVC pobiera najnowszą wersję pliku z serwera Usługi Azure DevOps.

Polecenie view nie dodaje plików do obszaru roboczego ani ich wyewidencjonowania. Aby uzyskać więcej informacji na temat pobierania wersji serwera usługi Azure DevOps pliku i wyewidencjonowania go, zobacz Get command and Checkout and Edit commands (Uzyskiwanie poleceń i wyewidencjonowywanie i edytowanie).

Możesz użyć difference polecenia , aby wyświetlić różnice między dwiema wersjami pliku. Aby uzyskać więcej informacji, zobacz Polecenie Różnice.

Aby uzyskać więcej informacji na temat korzystania z tf narzędzia wiersza polecenia, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Opcje danych wyjściowych

  • Domyślnie funkcja TFVC wyświetla zawartość pliku w przeglądarce skojarzonej z typem pliku.

  • Jeśli dołączysz /console opcję, funkcja TFVC wyświetla zawartość pliku w konsoli poleceń. Podobnie, jeśli funkcja TFVC nie może zlokalizować przeglądarki dla określonego typu pliku, wyświetla zawartość pliku w konsoli poleceń.

  • Zawartość pliku można przekierować do standardowych danych wyjściowych przy użyciu polecenia | lub \>. Ta opcja umożliwia zapisanie pliku w innym pliku lub przekazanie go do innego programu na potrzeby przetwarzania końcowego.

Przykłady

Poniższy przykład przedstawia najnowszą wersję pliku 314.cs:

c:\projects>tf view 314.cs

W poniższym przykładzie jest wyświetlana wersja 314.cs zaewidencjonowana przy użyciu zestawu zmian 1999:

c:\projects>tf view /version:C1999 314.cs

Poniższy przykład pobiera wersję 5 314.cs i zapisuje go w pliku 314.old:

c:\projects>tf view /version:5 314.cs > 314.old

Poniższy przykład przedstawia najnowszą wersję każdego pliku zgodnego z wyrażeniem wieloznacznymi *.cs:

c:\projects>tf view *.cs