工作區指令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） workspaces 命令會顯示系統中工作區的相關信息，並更新 Azure DevOps 伺服器上使用者名稱或計算機名稱變更的快取資訊。
先決條件
若要使用 workspaces 命令，請將 Read 權限設定為 Allow。 如需詳細資訊，請參閱 預設 TFVC 權限。
語法
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
參數
下列各節說明 workspaces 命令的自變數和選項。
參數
自變數
描述
<owner-name>
提供值給 [/owner] 選項。 使用空字串 （“”） 來比對任何使用者所建立的工作區。
<computer-name>
提供值給 [/computer] 選項。 使用空字串 （“”） 來比對任何電腦上的工作區。
<workspace-name>
指定要顯示相關信息的工作區名稱。 如果未指定值，則會顯示伺服器中所有工作區的相關信息。 您也可以使用星號 \ 通配符來顯示伺服器所有工作區的相關信息。
<old-user-name>
提供 /updateUserName 選項的舊用戶名稱。
<old-computer-name>
提供 /updateComputerName 選項的舊計算機名稱。
<team-project-collection-url>
專案集合的 URL，其中包含您要顯示資訊的工作區，例如，https://myserver:8080/tfs/DefaultCollection。
<username>
提供值給 [/login] 選項。 您可以將此值指定為 DOMAIN\<username> 或 <username>。
<password>
提供值給 [/login] 選項。
選項
選項
描述
/owner
指定建立工作區的用戶名稱。 如果未指定任何擁有者，TFVC 只會傳回目前用戶所擁有的工作區相關信息。
/computer
指定要篩選伺服器工作區清單的用戶端電腦名稱。 如果未指定計算機，TFVC 只會傳回目前電腦上工作區的相關信息。
/format
指定工作區資訊的格式。
Brief 傳回沒有對應的工作區資訊。
Detailed 傳回工作區信息和對應。
Xml 傳回工作區資訊、對應、最新的存取日期，以及擁有者別名。 只有在指定 /collection 選項時，才能使用詳細格式。
Brief 是預設值。
/updateUserName
針對已變更網路使用者名稱的使用者，更新 Azure DevOps 伺服器上的安全性識別資訊。 如果您指定此選項，也必須使用 /collection 選項來指定專案集合。
/updateComputerName
指示 TFVC 更新其數據表，以反映用戶端電腦名稱的變更。 如果您指定此選項，也必須使用 /collection 選項來指定專案集合。
/remove
從用戶端快取中移除指定之專案集合的指定工作區專案。
/collection
指定專案集合。
/login
指定要向 Azure DevOps Server 驗證使用者的使用者名稱和密碼。
言論
tf 命令行公用程式的 workspaces 命令會顯示目前計算機上 工作區、指定使用者擁有或與特定 Azure DevOps 伺服器相關聯之所有工作區的相關信息。 針對每個工作區，TFVC 會顯示名稱、擁有者、批注和計算機名稱。 透過詳細的輸出，它也會顯示工作區對應。 除非您提供像是擁有者、計算機或工作區名稱的篩選，否則 TFVC 只會顯示您所建立工作區的相關信息。
如需如何編輯工作區屬性的詳細資訊，請參閱
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
例子
下列範例會顯示目前電腦上目前使用者的所有工作區清單：
c:\projects>tf workspaces
下列範例會針對在位址 https://myserver:8080/tfs/DefaultCollection的下列專案集合中建立的所有計算機上，顯示所有使用者的所有工作區清單：
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
下列範例會顯示目前使用者已在位址 https://myserver:8080/tfs/DefaultCollection的專案集合中建立之所有工作區的詳細資訊：
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
下列範例會顯示工作區 WS1的詳細資訊，該工作區由目前用戶擁有，且位於目前計算機上。 顯示的資訊包含工作區對應清單。
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
下列範例會從位於位址 https://myserver:8080/tfs/DefaultCollection的專案集合中，從快取中移除所有快取的工作區：
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection