Polecenie stanu (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) status lub jego alias stat, wyświetla informacje o oczekujących zmianach w plikach i folderach oraz oczekujących kandydatów zmiany w co najmniej jednym obszarze roboczym. W przypadku korzystania z /shelveset opcji polecenie wyświetla informacje o oczekujących zmianach w zestawie na półce.

Uwaga

Oczekujący kandydat na zmianę to plik w folderze lub podfolderze obszaru roboczego, który nie został dodany do kontroli wersji. Aby wyświetlić wszystkich oczekujących kandydatów do zmian w programie Visual Studio, przejdź do pozycji Team Explorer>Oczekujące zmiany wykluczone zmiany>, a następnie wybierz pozycję Wykryto.

Wymagania wstępne

Aby użyć status polecenia, musisz mieć uprawnienie Odczyt dla elementu źródłowego, a uprawnienia Wyewidencjonuj i Scal dla folderu docelowego ustaw wartość Zezwalaj. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

Parametry

Argumenty

Argument

Opis

/collection: <TeamProjectCollectionUrl>

Jeśli używasz /workspace opcji, określa adres URL kolekcji projektu, która zawiera obszar roboczy zawierający oczekujące zmiany. Na przykład: http://myserver:8080/tfs/DefaultCollection.

Jeśli nie zostanie określony, domyślnie kolekcja projektów jest przyjmowana jako kolekcja zawierająca obszar roboczy mapujący bieżący katalog.

Ignorowane, jeśli nie używasz /workspace opcji .

Uwaga

Zobacz Uwagi dotyczące ograniczeń tej opcji.

/format

Określa, ile szczegółów ma być wyświetlanych dla każdej oczekującej zmiany:

  • Brief (ustawienie domyślne): wyświetla jeden wiersz dotyczący każdej oczekującej zmiany, która zawiera: nazwę pliku, zmiany, czy element jest zablokowany zgodnie z gwiazdką *, ścieżką lokalną i użytkownikiem, jeśli używa opcji /collection i /workspace . Niektóre dane mogą zostać obcięte.
  • Detailed: Wyświetla pełny opis każdej oczekującej zmiany. Oprócz powyższych informacji ta opcja wyświetla więcej danych, takich jak data i godzina.

<itemspec>

Określa elementy, dla których mają być oczekujące dane zmiany. Aby uzyskać informacje o składni, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation). Można określić więcej niż jeden itemspec argument.

/login

Określa konto użytkownika, które ma być używane do uruchamiania polecenia. Zobacz Używanie poleceń kontroli wersji programu Team Foundation.

/recursive

Rekursywnie pobiera dane dotyczące oczekujących zmian w elementach w określonym katalogu i wszystkich podkatalogach.

/shelveset:<shelvesetname>[;<shelvesetowner>]

Określa zestaw na półce zawierający zmiany, które chcesz wyświetlić.

Tej opcji nie można połączyć z opcją /workspace .

/user

Wyświetla listę wszystkich oczekujących zmian wprowadzonych przez określonego użytkownika. Gwiazdka * zawiera dane dotyczące zmian ze strony wszystkich użytkowników. Wartość domyślna to użytkownik bieżący.

Dopuszczalne wartości dla tej opcji:

  • <username>
  • <useraccount>
  • Gwiazdka *

Uwaga

Zobacz Uwagi dotyczące ograniczeń tej opcji.

/workspace:<workspacename>[;<workspaceowner>]

Określa nazwę obszaru roboczego, który zawiera oczekujące zmiany. Jeśli nie zostanie określony, obszar roboczy jest tym, który mapuje bieżący katalog.

Możesz określić workspaceowner , aby pobrać dane dotyczące oczekujących zmian w obszarze roboczym należącym do określonego użytkownika. Jeśli nie zostanie określony, obszar roboczy zostanie uznany za bieżącego użytkownika lub jeśli zostanie określony, /login:<username>.

Tej opcji nie można połączyć z opcją /shelveset .

Uwaga

Zobacz Uwagi dotyczące ograniczeń tej opcji.

Uwagi

Możesz użyć status polecenia , aby wyświetlić oczekujące zmiany w bieżącym obszarze roboczym, na przykład obszar roboczy, który mapuje bieżący katalog, niezależnie od tego, czy jest to lokalny obszar roboczy, czy obszar roboczy serwera. Możesz również użyć tego polecenia, aby wyświetlić oczekujące zmiany w obszarze roboczym serwera zdalnego, na przykład zmiany wprowadzone przez innego użytkownika na innej maszynie deweloperów przy użyciu /collectionopcji , /useri /workspace . Nie można jednak wyświetlić oczekujących zmian w zdalnym lokalnym obszarze roboczym.

Aby uzyskać więcej informacji, zobacz Wybieranie między użyciem obszaru roboczego lokalnego lub serwera.

Przykłady

We wszystkich poniższych przykładach załóżmy, że $/SiteApp/Main/ jest mapowany na c:\code\SiteApp\Main\ w obszarze roboczym.

Wyświetlanie listy wszystkich zmian w bieżącym obszarze roboczym

W poniższym przykładzie wymieniono wszystkie oczekujące zmiany w obszarze roboczym:

c:\code\SiteApp\Main\SolutionA\>tf stat

Wyświetlanie listy wszystkich zmian w folderze

W poniższym przykładzie wymieniono wszystkie oczekujące zmiany we wszystkich elementach w folderze SolutionA :

c:\code\SiteApp\Main>tf stat SolutionA\*

Wyświetlanie listy wszystkich zmian w folderze i jego podfolderach

W poniższym przykładzie wymieniono oczekujące zmiany we wszystkich elementach w folderze SolutionA , w tym zmiany w jego podfolderach:

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

Następne kroki