檢視命令 (Team Foundation 版本控制)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 (TFVC) view
命令會擷取特定版本的檔案、將它儲存在電腦上的暫存資料夾中,並加以顯示。
必要條件
若要使用 view
命令,您必須將 [讀取 ] 權限設定為 [允許]。 如需詳細資訊,請參閱 預設 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
自變數和選項。
引數
Argument
說明
<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>
提供 選項的值,例如 C3/version
。 如需 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 殼層來開啟檔案。
備註
view
命令行公用程式的命令tf
會從 Azure DevOps 伺服器擷取檔案的唯讀複本、將檔案儲存在電腦上的暫存資料夾中,並顯示檔案內容。 除非您指定特定版本,否則 TFVC 會從 Azure DevOps 伺服器擷取最新版本的檔案。
view
命令不會將檔案新增至您的工作區,或將其取出。如需如何取得檔案的 Azure DevOps 伺服器版本並簽出的詳細資訊,請參閱取得命令和簽出和編輯命令。
您可以使用 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