共用方式為


狀態指令 (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>

當您使用 /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

下一步