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 view
tf
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