更新：2007 年 11 月
顯示系統中工作區的詳細資訊，並更新 Team Foundation 伺服器上有關使用者名稱或電腦名稱變更的快取資訊。
必要的使用權限
若要使用 workspaces 命令，您必須將 [讀取] 權限設定為 [允許]。如需詳細資訊，請參閱 Team Foundation Server 使用權限。
tf workspaces [/owner:ownername] [/computer:computername]
[/server:servername] [/format:(brief|detailed)]
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName]
workspacename
tf workspaces /remove:(*|workspace1[,workspace2,...])
/server:(*|server)
參數
引數 |
描述 |
|---|---|
ownername |
提供 /owner 選項的值。指定 "*" 以符合由任何使用者所建立的工作區。 |
computername |
提供 /computer 選項的值。指定 "*" 以符合任何電腦上的工作區。 |
servername |
提供 /server 選項的值。例如：TeamServer2。 |
workspacename |
指定要顯示其相關資訊的工作區的名稱。如果未指定 workspacename，就會顯示伺服器中所有工作區的相關資訊。還可以使用 "*" 萬用字元以顯示伺服器中所有工作區的相關資訊。 |
oldUserName |
提供 /updateUserName 選項的舊使用者名稱。 |
oldComputerName |
提供 /updateComputerName 選項的舊電腦名稱。 |
選項 |
描述 |
|---|---|
/owner |
指定建立此工作區的使用者名稱。如果沒有指定擁有者，Team Foundation 就只會傳回由目前使用者所擁有的工作區的相關資訊。 |
/computer |
指定用戶端電腦的名稱，該名稱將用來篩選伺服器的工作區清單。如果沒有指定電腦，Team Foundation 就只會傳回目前電腦上的工作區的相關資訊。 |
/server |
指定 Team Foundation Server 的名稱，該名稱將用來篩選您所指定的工作區清單。如果沒有提供 servername，Team Foundation 會傳回使用本機快取檔案的所有已知 Team Foundation 伺服器上的工作區的相關資訊。 |
/format |
指定工作區資訊的格式。Brief 會傳回工作區資訊，但不包含對應。Detailed 則會傳回工作區資訊和對應。詳細的格式只能用於指定了 /server 選項時。Brief 是預設值。 |
/updateUserName |
針對網路使用者名稱經過變更的使用者，更新 Team Foundation 伺服器上的安全性識別資訊。如果指定這個選項，還必須使用 /server 選項指定伺服器。 |
/updateComputerName |
指示 Team Foundation 更新其資料表以反映用戶端電腦名稱的變更。如果指定這個選項，還必須使用 /server 選項指定伺服器。 |
/remove |
從用戶端快取移除指定伺服器的指定工作區項目。 |
備註
tf 命令列公用程式的 workspaces 命令會顯示目前電腦上、由特定使用者所擁有的工作區的相關資訊，或針對與特定 Team Foundation Server 相關聯的所有工作區顯示相關資訊。Team Foundation 會針對每個工作區顯示名稱、擁有人、註解和電腦名稱。如果使用詳細輸出，則也會顯示工作區對應。除非提供擁有人、電腦或工作區名稱之類的篩選條件，否則 Team Foundation 只會顯示您所建立的工作區的相關資訊。
如需如何編輯工作區屬性的詳細資訊，請參閱 Workspace 命令。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
範例
下列範例顯示目前電腦上的目前使用者的所有工作區清單。
c:\projects>tf workspaces
下列範例顯示建立在伺服器 teamserver2 上的所有電腦的所有使用者的所有工作區清單。
c:\projects>tf workspaces /owner:* /computer:* /server:teamserver2.
下列範例顯示目前使用者為 teamserver2 伺服器所建立的所有工作區的詳細資訊。
c:\projects>tf workspaces /computer:* /format:detailed /server:teamserver2
下列範例顯示的詳細資訊包含有關工作區 "WS1" 的工作區對應清單，該工作區是由目前的使用者所擁有，且位於目前的電腦。
c:\projects>tf workspaces /format:detailed /server:teamserver2 WS1
下列範例從伺服器 teamserver2 的快取移除所有快取的工作區。
c:\projects>tf workspaces /remove:* /server:teamserver2