檢視命令 (Team Foundation 版本控制)
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 (TFVC) view
命令會擷取特定版本的檔案、將它儲存在電腦上的暫存資料夾中,並加以顯示。
先決條件
若要使用 view
命令,請將 Read 權限設定為 Allow。 如需詳細資訊,請參閱 預設 TFVC 權限。
語法
tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec>
[/version:<version-spec>] [/login:<username>,[<password>]]
參數
下列各節說明 view
命令的自變數和選項。
參數
自變數
描述
<team-project-collection-url>
提供專案集合的 URL,其中包含您想要擷取相關信息的特定檔案版本,例如,https://myserver:8080/tfs/DefaultCollection
。
<shelveset-name> [:<owner>]
識別擱置集。 選擇性 <owner>
自變數可用來指定目前使用者未擁有的擱置集。
<item-spec>
識別要擷取的檔案或資料夾。 如需 TFVC 如何剖析 <item-spec>
自變數以判斷哪些專案在範圍內的詳細資訊,請參閱 使用 Team Foundation 版本控制命令 - 使用選項來修改命令如何。
注意
您可以指定多個 <item-spec>
自變數。
<version-spec>
提供 /version
選項的 C3 等值。 如需 TFVC 如何剖析版本規格以判斷其範圍內哪些專案的詳細資訊,請參閱 使用 Team Foundation 版本控制命令。
<username>
提供值給 [/login
] 選項。 您可以將此值指定為 DOMAIN\<username>
或 <username>
。
<password>
提供值給 [/login
] 選項。
<local-file>
提供輸出檔案資料夾的路徑。
選項
選項
描述
/console
指定應該將檔案輸出導向主控台。 如果您想要使用主控台重新導向將檔案寫入磁碟,但使用與版本設定專案不同的名稱或位置,這個選項會很有用。
/recursive
檢視指定目錄和任何子目錄中的所有專案。
/shelveset
依名稱指定擱置集。
/noprompt
指定當您在符合多個檔案的 <item-spec>
自變數中包含通配符運算式時,TFVC 不應該在顯示每個檔案之前提示您。
/version
指定要開啟以供檢視的檔案版本。 如果您省略此選項,view
擷取最新的 Azure DevOps 伺服器版本。
/collection
指定專案集合。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
/output
將檔案輸出至本機資料夾,而不是叫用 Windows 殼層來開啟檔案。
言論
tf
命令行公用程式的 view
命令會從 Azure DevOps 伺服器擷取檔案的唯讀複本、將檔案儲存在電腦上的暫存資料夾中,並顯示檔案內容。 除非您指定特定版本,否則 TFVC 會從 Azure DevOps 伺服器擷取最新版本的檔案。
view
命令不會將檔案新增至您的工作區或取出檔案。如需如何取得檔案的 Azure DevOps 伺服器版本並簽出的詳細資訊,請參閱 Get 命令 和 簽出和編輯命令。
您可以使用 difference
命令來檢視檔案兩個版本之間的差異。 如需詳細資訊,請參閱 Difference 命令。
如需如何使用 tf
命令行公用程式的詳細資訊,請參閱 使用 Team Foundation 版本控制命令。
輸出選項
根據預設,TFVC 會在與文件類型相關聯的查看器中顯示檔案的內容。
如果您包含
/console
選項,TFVC 會將檔案的內容列印至命令主控台。 同樣地,如果 TFVC 找不到您所指定檔案類型的查看器,它會將檔案內容列印至命令控制台。您可以使用
|
或\>
,將檔案的內容重新導向至標準輸出。 此選項可讓您將檔案儲存至另一個檔案,或將它傳遞給另一個程式以進行後續處理。
例子
下列範例會顯示最新版本的檔案 314.cs:
c:\projects>tf view 314.cs
下列範例會顯示已簽入變更集 1999 的 314.cs 版本:
c:\projects>tf view /version:C1999 314.cs
下列範例會擷取第 5 版的 314.cs,並將它寫入檔案 314.old:
c:\projects>tf view /version:5 314.cs > 314.old
下列範例會顯示符合通配符表達式 *.cs之每個檔案的最新版本:
c:\projects>tf view *.cs