分享方式:


工作區指令 (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