工作區指令 （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 命令，您必須將 [讀取 ] 權限設定為 [允許]。 如需詳細資訊，請參閱 預設 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 自變數和選項。
引數
Argument
說明
<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 驗證使用者的使用者名稱和密碼。
備註
workspaces命令行公用程式的命令tf會顯示目前計算機上工作區的相關信息、由指定用戶擁有的工作區，或針對與特定 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