Příkaz Stav (Správa verzí Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Příkaz TFVC (Team Foundation Version Control) status
nebo jeho alias stat
, zobrazí informace o čekajících změnách souborů a složek a čekajících kandidátech na změnu v jednom nebo více pracovních prostorech. Když použijete možnost /shelveset
, zobrazí příkaz informace o čekajících změnách v sadě odložených změn.
Poznámka
Čekající kandidát na změnu je soubor ve složce nebo podsložce pracovního prostoru, které nejsou přidány do správy verzí. Pokud chcete zobrazit všechny čekající změny v sadě Visual Studio, přejděte do Team Exploreru>Čekající změny>vyloučené změnya pak vyberte Zjištěné.
Požadavky
Pokud chcete použít příkaz status
, mají oprávnění Číst pro zdroj a oprávnění Rezervovat a Sloučit pro cílovou složku nastavená na Povolit. Další informace najdete v tématu Výchozí oprávnění TFVC.
Syntax
tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]]
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]
Parametry
Argumenty
argumentu
popis
/collection: <TeamProjectCollectionUrl>
Pokud použijete možnost /workspace
, určuje adresu URL kolekce projektů, která obsahuje pracovní prostor, který obsahuje čekající změny. Příklad: http://myserver:8080/tfs/DefaultCollection
.
Pokud není zadáno, předpokládá se, že kolekce projektů je ta, která obsahuje pracovní prostor, který mapuje aktuální adresář.
Ignorováno, pokud nepoužíváte možnost /workspace
.
Poznámka
Omezení této možnosti najdete poznámky.
/format
Určuje, kolikpodrobnostch
-
Brief
(výchozí): Zobrazí jeden řádek o každé čekající změně, která zahrnuje: název souboru, změny, zda je položka uzamčena hvězdičkou *, místní cestou a uživatelem, pokud používáte možnosti/collection
a/workspace
. Některá data můžou být zkrácena. -
Detailed
: Zobrazí úplný popis každé čekající změny. Kromě výše uvedených informací zobrazí tato možnost více dat, jako je datum a čas.
<itemspec>
Určuje položky, pro které chcete čekající data změn. Syntaxi najdete v tématu Použití příkazů správy verzí Team Foundation. Můžete zadat více než jeden itemspec
argument.
/login
Určuje uživatelský účet, který se má použít ke spuštění příkazu. Viz Použití příkazů správy verzí Team Foundation.
/recursive
Rekurzivně načte data o čekajících změnách položek v zadaném adresáři a všech podadresářích.
/shelveset:<shelvesetname>[;<shelvesetowner>]
Určuje sadu odložených změn, které chcete vypsat.
Tuto možnost nelze kombinovat s možností /workspace
.
/user
Zobrazí seznam všech čekajících změn provedených zadaným uživatelem. Hvězdička *
zahrnuje data o změnách všech uživatelů. Výchozí hodnota je aktuální uživatel.
Přijatelné hodnoty pro tuto možnost:
<username>
<useraccount>
- Hvězdička
*
Poznámka
Omezení této možnosti najdete poznámky.
/workspace:<workspacename>[;<workspaceowner>]
Určuje název pracovního prostoru, který obsahuje čekající změny. Pokud není zadaný, je pracovní prostor ten, který mapuje aktuální adresář.
Můžete zadat workspaceowner
pro získání dat o čekajících změnách v pracovním prostoru, který patří konkrétnímu uživateli. Pokud není zadaný, předpokládá se, že pracovní prostor je aktuálním uživatelem nebo je-li zadán, /login:<username>
.
Tuto možnost nelze kombinovat s možností /shelveset
.
Poznámka
Omezení této možnosti najdete poznámky.
Poznámky
Pomocí příkazu status
můžete zobrazit čekající změny v aktuálním pracovním prostoru, například pracovní prostor, který mapuje aktuální adresář bez ohledu na to, jestli se jedná o místní pracovní prostor nebo pracovní prostor serveru. Pomocí tohoto příkazu můžete také zobrazit čekající změny v pracovním prostoru vzdáleného serveru, například změny provedené jiným uživatelem na jiném vývojovém počítači, pomocí možností /collection
, /user
a /workspace
. Nemůžete ale zobrazit čekající změny ve vzdáleném místním pracovním prostoru.
Další informace najdete v tématu Rozhodování mezi použitím místního nebo serverového pracovního prostoru.
Příklady
Ve všech následujících příkladech předpokládejme, že $/SiteApp/Main/ se mapuje na c:\code\SiteApp\Main\ v pracovním prostoru.
Výpis všech změn v aktuálním pracovním prostoru
Následující příklad uvádí všechny čekající změny v pracovním prostoru:
c:\code\SiteApp\Main\SolutionA\>tf stat
Výpis všech změn ve složce
Následující příklad uvádí všechny čekající změny všech položek ve složce SolutionA:
c:\code\SiteApp\Main>tf stat SolutionA\*
Zobrazení seznamu všech změn ve složce a jejích podsložkách
Následující příklad uvádí čekající změny všech položek ve složce SolutionA, včetně změn v jejích podsložkách:
c:\code\SiteApp\Main>tf stat SolutionA\* /recursive
Další kroky
Většina změn, které provedete v souborech v rámci správy verzí, se zařadí do fronty jako čekající změny ve vašem pracovním prostoru. Další informace najdete v tématu Vývoj kódu a správa čekajících změn a Vytváření a práce s pracovními prostory.
Pomocí příkazu Rozdíl můžete získat podrobnosti o změnách úprav nebo změnách obsahu v souboru.
Pokud potřebujete vyhradit změny a možná také chcete pracovní prostor vyčistit pro jiný úkol, použijte příkaz Shelve. Další informace o sadách odložených informací najdete v tématu Pozastavení práce a správa sad odložených.
Až budete připravení vrátit se změnami změny na serveru, použijte příkaz Checkin.
Další informace o tom, jak používat nástroj
tf
, najdete v tématu Použití příkazů správy verzí Team Foundation