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