Dir 命令 （Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
此命令dir會顯示伺服器 Team Foundation 版本控制 的所有或部分內容（TFVC）。
必要條件
若要使用 dir 命令，您必須將 [讀取 ] 權限設定為 [允許]。 如需詳細資訊，請參閱 預設 TFVC 許可權。
語法
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
參數
引數
Argument
說明
<itemspec>
識別要傳回相關信息的檔案或資料夾。 如需 TFVC 如何剖析 itemspec 以判斷哪些專案在範圍內的詳細資訊，請參閱 使用選項來修改命令的運作方式。
注意
您可以指定多個 itemspec 自變數。
<versionspec>
選項的使用者提供值 /version 。 如需 TFVC 如何剖析版本規格以判斷其範圍內哪些專案的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
<username>
提供 選項的值 /login 。 您可以將使用者名稱值指定為 DOMAIN\username 或 username。
<TeamProjectCollectionUrl>
專案集合的 URL，其中包含您要顯示資訊的一或多個檔案或資料夾，例如 http://myserver:8080/tfs/DefaultCollection/。
選項。
選項
說明
/version
指定 TFVC 應該只顯示特定版本的檔案和資料夾。
/recursive
顯示指定目錄中的所有檔案和子資料夾。
/folders
只顯示資料夾。
/deleted
顯示已刪除的項目和現有的專案。 刪除的專案後面接著 ;Xn ，其中 n 是刪除標識碼。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
/collection
指定專案集合。
備註
此命令 dir 會在檔案的 Azure DevOps 伺服器複本上運作，而不是本機複本。 此命令會使用本機對應資料夾來找出適當的 Azure DevOps 伺服器路徑。 您可以使用此命令來探索 Azure DevOps 伺服器，並識別您可能必須取得的檔案。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用Team Foundation版本控制命令。
範例
下列範例會顯示 c：\projects 對應至 Azure DevOps 伺服器資料夾中的檔案、資料夾、子資料夾和檔案清單。 項目數目也會列出。 如需如何檢視和編輯工作資料夾對應的詳細資訊，請參閱 工作區命令 和 Workfold 命令。
c:\projects>tf dir /recursive
下列範例會顯示位於 314dir 路徑的所有 Azure DevOps 伺服器檔案。 314dir 子資料夾不需要存在於本機資料夾中。
c:\projects>tf dir 314dir
下列範例會顯示 314dir Azure DevOps 伺服器路徑中標示My label的檔案版本。 314dir 子資料夾不需要存在於本機資料夾中。
c:\projects>tf dir /version:L"My label" 314dir
下列範例會顯示 Azure DevOps 伺服器根目錄中的所有資料夾。 本機工作資料夾會被忽略，因為 $/ 表示 Azure DevOps 伺服器路徑。
c:\projects>tf dir /folders $/
下列範例會列出 Azure DevOps 伺服器中的每個檔案和資料夾。
c:\projects>tf dir /recursive $/
下列範例會列出目前資料夾中的所有專案，包括已刪除的專案及其刪除標識碼。
c:\projects>tf dir /deleted