Status 命令

顯示一個或多個工作區中，檔案和資料夾之暫止變更的相關資訊。 或是，當您使用 /shelveset 選項時，在擱置集中顯示暫止變更的相關資訊。

**需求：**請參閱 Team Foundation Server 的權限參考。

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 選項時，指定包含暫止變更之工作區的 Team 專案集合 URL。 例如：http://myserver:8080/tfs/DefaultCollection。 如果未指定，根據預設，會假設 Team 專案集合包含對應至目前目錄的工作區。 如果您未使用 /workspace 選項，則加以忽略。 注意事項 如需這個選項的限制，請參閱下方的＜備註＞。
/format	指定每個暫止的變更要顯示的詳細資料程度： Brief (預設值)：每項暫止的變更顯示一行，包括：檔名、變更、項目是否已鎖定 (以星號 (*) 表示)、本機路徑和使用者 (如果使用 /collection 和 /workspace 選項)。 某些資料可能會被截斷。 Detailed：顯示每項暫止變更的完整描述。 除了上述資訊以外，這個選項還會顯示其他資料，例如，日期與時間和鎖定。
itemspec	指定您想要顯示的暫止變更資料項目。 如需語法資訊，請參閱 Team Foundation 版本控制命令參考。 您可以指定多個 itemspec 引數。
/login	指定用來執行命令的使用者帳戶。 請參閱 Team Foundation 版本控制命令參考。
/recursive	以遞迴方式擷取有關所指定目錄和所有子目錄中項目的暫止變更資料。
/shelveset:shelvesetname[;shelvesetowner]	指定包含您要列出之變更的擱置集。 這個選項無法與 /workspace 選項合併使用。
/user	列出指定的使用者所做的所有暫止變更。 星號 (*) 會包括所有使用者的變更資料。 預設為目前使用者。 注意事項 如需這個選項的限制，請參閱下方的＜備註＞。
/workspace:workspacename[;workspaceowner]	指定包含暫止變更的工作區名稱。 如果未指定，則工作區就是對應至目前目錄的工作區。 您可以指定 workspaceowner，取得屬於特定使用者的工作區中有關暫止變更的資料。 如果未指定，工作區會假設為目前使用者，如果已指定，則為 /login:username。 這個選項無法與 /shelveset 選項合併使用。 注意事項 如需這個選項的限制，請參閱下方的＜備註＞。

備註

您可以使用 Status 命令檢視目前工作區 (例如，對應 [命令提示字元] 視窗中目前目錄的工作區) 中暫止的變更 (不論是本機工作區或伺服器工作區)。 您也可以使用這個命令透過 /collection、/user 和 /workspace 選項檢視遠端伺服器工作區中暫止的變更 (例如，其他使用者在另一部開發電腦上所做的變更)。 不過，您無法檢視遠端本機工作區中暫止的變更。

請參閱：決定使用本機還是伺服器工作區。

範例

在下列所有範例中，都會假設 $/SiteApp/Main/ 對應至工作區中的 c:\code\SiteApp\Main\。

列出目前工作區中所有的變更

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

列出工作區中所有暫止的變更。

列出資料夾中的所有變更

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

列出 SolutionA 資料夾中所有項目的所有暫止的變更。

列出資料夾及其子資料夾中的所有變更。

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

列出 SolutionA 資料夾中所有項目 (包括其子資料夾中所有項目) 的暫止變更。

Visual Studio 中的運作方式

• 開發程式碼和管理暫止的變更使用 Visual Studio 檢視和管理暫止的變更。

祕訣

• 您在版本控制下對檔案所做的大多數變更都會排入佇列，成為您工作區中暫止的變更。 請參閱開發程式碼和管理暫止的變更和建立和使用工作區。

• 您可以使用 Difference Command取得在檔案中編輯變更 (變更內容) 的詳細資料。

• 如果您需要保留一些變更 (或許也想要清理工作區以便進行另一項工作)，請使用 Shelve 命令。 如需有關擱置集的詳細資訊，請參閱暫停工作和管理擱置集。

• 當您準備好將變更簽入至伺服器時，請使用 Checkin 命令。