狀態指令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） status 命令或其別名 stat，會顯示一或多個工作區中檔案和資料夾暫止變更暫止變更的相關信息。 當您使用 [/shelveset] 選項時，命令會顯示擱置集中暫止變更的相關信息。
注意
暫止的變更候選專案是工作區資料夾或子資料夾中的檔案，未新增至版本控制。 若要在 Visual Studio 中檢視所有擱置中的變更候選專案，請移至
先決條件
若要使用 status 命令，請具有來源專案的 讀取 許可權，以及 簽出 和 合併 許可權，目標資料夾設定為 Allow。 如需詳細資訊，請參閱 預設 TFVC 權限。
語法
tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]]
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]
參數
參數
自變數
描述
/collection: <TeamProjectCollectionUrl>
當您使用 [/workspace] 選項時，指定專案集合的 URL，其中包含包含暫止變更的工作區。 例如：http://myserver:8080/tfs/DefaultCollection。
如果未指定，預設專案集合會假設為包含對應目前目錄之工作區的專案集合。
如果您沒有使用 [/workspace] 選項，則會略過。
注意
如需此選項的限制，請參閱<
/format
指定要顯示每個暫止變更的詳細資料：
-
Brief（預設值）：顯示每個暫止變更的一行，包括：檔名、變更、專案是否鎖定，如星號 *、本機路徑，以及使用/collection和/workspace選項的使用者。 某些數據可能會遭到截斷。 -
Detailed：顯示每個暫止變更的完整描述。 除了上述資訊之外，此選項也會顯示更多數據，例如日期和時間。
<itemspec>
指定您要暫止變更資料的專案。 如需語法，請參閱 使用 Team Foundation 版本控制命令。 您可以指定多個 itemspec 自變數。
/login
指定要用來執行命令的用戶帳戶。 請參閱 使用 Team Foundation 版本控制命令。
/recursive
以遞歸方式擷取指定目錄中專案和任何子目錄中之暫止變更的相關數據。
/shelveset:<shelvesetname>[;<shelvesetowner>]
指定包含您想要列出之變更的擱置集。
此選項無法與 /workspace 選項結合。
/user
列出指定使用者所做的所有擱置變更。 星號 * 包含所有用戶變更的相關數據。 預設值為目前的使用者。
這個選項可接受的值：
<username><useraccount>- 星號
*
注意
如需此選項的限制，請參閱<
/workspace:<workspacename>[;<workspaceowner>]
指定包含暫止變更的工作區名稱。 如果未指定，工作區就是對應目前目錄的工作區。
您可以指定 workspaceowner，以取得屬於特定使用者之工作區中暫止變更的相關數據。 如果未指定，則工作區會假設為目前使用者，或指定時，/login:<username>。
此選項無法與 /shelveset 選項結合。
注意
如需此選項的限制，請參閱<
言論
您可以使用 [status] 命令來檢視目前工作區中的暫止變更，例如對應目前目錄的工作區，不論它是本機工作區還是伺服器工作區。 您也可以使用此命令來檢視遠端伺服器工作區中的擱置變更，例如其他使用者在另一個開發計算機上，使用 /collection、/user和 /workspace 選項所做的變更。 不過，您無法在遠端本機工作區中檢視擱置中的變更。
如需詳細資訊，請參閱 使用本機或伺服器工作區。
例子
在下列所有範例中，假設 $/SiteApp/Main/ 會對應 至工作區中的 c：\code\SiteApp\Main\。
列出目前工作區中的所有變更
下列範例會列出工作區中的所有暫止變更：
c:\code\SiteApp\Main\SolutionA\>tf stat
列出資料夾中的所有變更
下列範例會列出 SolutionA 資料夾中所有項目的擱置變更：
c:\code\SiteApp\Main>tf stat SolutionA\*
列出資料夾及其子資料夾中的所有變更
下列範例會列出 SolutionA 資料夾中所有項目的擱置變更，包括其子資料夾中的變更：
c:\code\SiteApp\Main>tf stat SolutionA\* /recursive
後續步驟
您在版本控制下對檔案所做的大部分變更都會排入佇列，作為工作區中的擱置變更。 如需詳細資訊，請參閱 開發程式代碼及管理擱置中的變更， 和 建立和使用工作區。
您可以使用 Difference 命令 取得檔案中編輯變更或內容變更的詳細數據。
如果您需要保留變更，而且可能也想要清除工作區以進行另一項工作，請使用 Shelve 命令。 如需擱置集的詳細資訊，請參閱 暫停您的工作和管理擱置集。
當您準備好要簽入伺服器的變更時，請使用 Checkin 命令。
如需如何使用
tf公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令