狀態指令 （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 中檢視所有擱置中的變更候選專案，請移至 [Team Explorer>擱置變更排除的變更>]，然後選取 [偵測到]。
必要條件
若要使用 status 命令，您必須具有來源專案的 [讀取] 許可權，以及目標資料夾的 [取出] 和 [合併] 許可權設定為 [允許]。 如需詳細資訊，請參閱 預設 TFVC 許可權。
語法
tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]]
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]
參數
引數
Argument
說明
/collection: <TeamProjectCollectionUrl>
/format
指定要顯示每個暫止變更的詳細資料：
Brief（預設值）：顯示每個暫止變更的一行，包括：檔名、變更、專案是否鎖定，如星號 *、本機路徑，以及使用者使用/collection和/workspace選項所指示。 某些數據可能會遭到截斷。Detailed：顯示每個暫止變更的完整描述。 除了上述資訊之外，此選項也會顯示更多數據，例如日期和時間。
<itemspec>
指定您要暫止變更資料的專案。 如需語法，請參閱 使用Team Foundation版本控制命令。 您可以指定多個 itemspec 自變數。
/login
指定要用來執行命令的用戶帳戶。 請參閱 使用Team Foundation版本控制命令。
/recursive
以遞歸方式擷取指定目錄中專案和任何子目錄中之暫止變更的相關數據。
/shelveset:<shelvesetname>[;<shelvesetowner>]
指定包含您想要列出之變更的擱置集。
此選項無法與 /workspace 選項結合。
/user
/workspace:<workspacename>[;<workspaceowner>]
備註
您可以使用 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版本控制命令