Udostępnij za pośrednictwem

Polecenie stanu (Kontrola wersji programu Team Foundation)

  • Artykuł

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

Visual Studio 2019 | Program Visual Studio 2022

Polecenie Kontroli wersji programu Team Foundation (TFVC) status lub jego alias statwyświetla informacje o oczekujących zmianach w plikach i folderach oraz oczekujących kandydatów na zmiany w co najmniej jednym obszarze roboczym. W przypadku korzystania z opcji /shelveset polecenie wyświetla informacje o oczekujących zmianach w zestawie półek.

Nuta

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 Team Explorer>oczekujących zmian>wykluczonych zmian, a następnie wybierz pozycję Wykryto.

Warunki wstępne

Aby użyć polecenia status, należy mieć uprawnienie Odczyt dla elementu źródłowego oraz Wyewidencjonuj i uprawnienia scalania dla folderu docelowego ustawione na Zezwalaj na. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.

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ów

opis

/collection: <TeamProjectCollectionUrl>

Jeśli używasz opcji /workspace, określa adres URL kolekcji projektów, 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 opcji /workspace.

Nuta

Zobacz uwagi, aby zapoznać się z ograniczeniami tej opcji.

/format

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

  • Brief (wartość domyślna): 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 korzysta z 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 argument itemspec.

/login

Określa konto użytkownika, które ma być używane do uruchamiania polecenia. Zobacz Use Team Foundation version control commands (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 bieżący użytkownik.

Dopuszczalne wartości dla tej opcji:

  • <username>
  • <useraccount>
  • * gwiazdki

Nuta

Zobacz uwagi, aby zapoznać się z ograniczeniami 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 uzyskać 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.

Nuta

Zobacz uwagi, aby zapoznać się z ograniczeniami tej opcji.

Uwagi

Możesz użyć polecenia status, aby wyświetlić oczekujące zmiany w bieżącym obszarze roboczym, na przykład obszar roboczy mapujący 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 opcji /collection, /useri /workspace. Nie można jednak wyświetlić oczekujących zmian w zdalnym lokalnym obszarze roboczym.

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

Przykłady

We wszystkich poniższych przykładach przyjęto założenie, ż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

Poniższy przykład zawiera listę wszystkich oczekujących zmian we wszystkich elementach w folderze SolutionA:

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

Wyświetlanie listy wszystkich zmian w folderze i jego podfolderach

Poniższy przykład zawiera listę oczekujących zmian we wszystkich elementach w folderze SolutionA, w tym zmiany w jego podfolderach:

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

Następne kroki