Status 命令
更新：2007 年 11 月
顯示在一或多個工作區中項目之暫止變更的詳細資訊。
必要的使用權限
若要使用 status 命令，您必須將所有指定之檔案或資料夾的 [讀取] 權限設定為 [允許]。如需詳細資訊，請參閱 Team Foundation Server 使用權限。
tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
參數
引數 |
描述 |
|---|---|
itemspec |
辨別要為其顯示狀態詳細資料的檔案或資料夾。如需 Team Foundation 如何剖析 itemspecs 以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (Team System)。 |
servername |
/server 選項的使用者提供值。範例：http://teamfoundation2:8080。 |
workspacename |
/workspace 選項的使用者提供值。 |
workspaceowner |
指定建立此工作區的使用者名稱。 |
shelvesetname |
/shelveset 選項的使用者提供值。 |
shelvesetowner |
指定擱置集擁有人的名稱。 |
username |
提供 /user 選項的值。根據網路設定，使用者名稱值可以用兩種方式表示：DOMAIN\username 或 username。 |
選項 |
描述 |
|---|---|
/server |
辨別 Team Foundation Server。如果此命令是從尚未對應至工作區的目錄叫用，就會需要這個選項。 |
/workspace |
指定要查看其變更清單的工作區名稱。如果未指定這個選項，且是從已加入工作區的目錄執行命令，就會使用目前的工作區。 這個選項無法與 /shelveset 選項合併使用。 |
/shelveset |
要查看其變更清單的擱置集名稱。 這個選項無法與 /workspace 選項合併使用。 |
/format |
狀態資訊格式。Brief 會顯示變更清單以及在暫止簽入時對其所做的變更。Detailed 則顯示完整的狀態資訊。Brief 是預設值。 |
/recursive |
顯示特定目錄及任何子目錄中所有項目的狀態資訊。 |
/user |
針對具名使用者篩選變更清單。可以使用星號 (*) 代表所有使用者。預設是目前的使用者。 |
備註
您可以使用 status 命令顯示暫止變更的清單。「暫止變更」(Pending Change)是尚未提交給伺服器並與已建立版本的變更集一起提供的檔案或資料夾修訂。如需詳細資訊，請參閱暫止的變更。
您還可以指定 /shelveset 選項，以顯示擱置集所包含的已擱置、沒有建立版本的變更的詳細資料。如需有關暫止變更和擱置變更之間差異的詳細資訊，請參閱使用版本控制擱置集。
如需其他 Team Foundation 命令的連結，內容提供伺服器中項目與對應至此伺服器之所有工作區的詳細資訊，請參閱可取得資訊的命令。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
命令輸出
如果暫止的變更類型為 rename，則會顯示新名稱。如需詳細資訊，請參閱 Rename 命令 (Team Foundation 版本控制)。
有兩種顯示模式：brief (簡短) 和 detailed (詳細)。
/Format:brief 會顯示項目的檔案名稱、變更和本機路徑、項目鎖定時所代表的暫止變更類型、進行變更的使用者，以及磁碟上項目工作區版本的位置。輸出會先依資料夾排序，然後再依資料夾中的檔案名稱排序。
/Format:detailed 會針對輸出中的每個暫止變更顯示數行資訊。詳細輸出包括簡短輸出所含的每項資訊，另外還附加日期、時間和其他資訊。
範例
下列範例針對目前工作區中的目前使用者，顯示所有暫止變更的相關資訊。目前工作區是本機目錄所對應到的工作區。
c:\projects>tf status
下列範例針對目前電腦 d:\src 下的目前使用者，顯示所有暫止變更。
c:\projects>tf status/recursive d:\src
下列範例針對 Beta1 工作區中的目前使用者，顯示所有暫止變更。
c:\projects>tf status/workspace:Beta1
下列範例針對使用者 Jason，顯示所有暫止變更的狀態資訊。
c:\projects>tf status/user:Jason
下列範例針對伺服器所有工作區的所有使用者，顯示所有暫止變更的狀態資訊。
c:\projects>tf status/user:*
下列範例針對位於 teamserver2 的伺服器的所有工作區中的目前使用者，顯示所有暫止變更的相關資訊。
c:\projects>tf status/server:teamserver2 /workspace:*
下列範例顯示 Joe 已在對應到 teamserver2 伺服器的所有工作區中進行但尚未簽入的所有變更的相關資訊。
c:\projects>tf status/server:teamserver2 /workspace:* /user:joe