Dir 命令
dir 命令會顯示 Team Foundation 版本控制 伺服器的所有或部分內容。
必要的使用權限
若要使用 dir 命令，您必須將 [讀取] 權限設定為 [允許]。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
參數
引數 |
描述 |
|---|---|
itemspec |
辨別要傳回資訊的檔案或資料夾。 如需 Team Foundation 如何剖析項目規格以判斷哪些項目位於範圍內的詳細資訊，請參閱命令列選項。 .gif "注意事項") 注意事項
您可以指定一個以上的 Itemspec 引數。
|
versionspec |
/version 選項的使用者提供值。 如需 Team Foundation 如何剖析版本規格以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (版本控制)。 |
username |
提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
TeamProjectCollectionUrl |
Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection/)，該集合包含一個或多個要為其顯示相關資訊的檔案或資料夾。 |
選項 |
描述 |
|---|---|
/version |
指定 Team Foundation 應該只能顯示特定版本的檔案或資料夾。 |
/recursive |
顯示指定目錄內的所有檔案和子資料夾。 |
/folders |
只顯示資料夾。 |
/deleted |
顯示刪除的項目和現有的項目。 刪除的項目後面會接著 ;X3，其中 3 是刪除 ID。 |
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
/collection |
指定 Team 專案集合。 |
備註
dir 命令是執行於 Team Foundation 版本控制伺服器的檔案複本，而不是本機複本。 該命令會使用本機對應的資料夾尋找適當的 Team Foundation 版本控制 伺服器路徑。 您可以使用這個命令瀏覽 Team Foundation 版本控制伺服器，並辨別您可能需要取得的檔案。
如需其他 Team Foundation 命令的連結，內容提供 Team Foundation 版本控制伺服器中項目與對應至此伺服器之所有工作區的詳細資訊，請參閱可取得資訊的命令。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
範例
下列範例所顯示的清單列出 c:\projects 所對應到的檔案、資料夾、子資料夾以及在 Team Foundation 版本控制伺服器資料夾中的檔案。 同時也會列出項目數。 如需如何檢視及編輯工作資料夾對應的詳細資訊，請參閱 Workspace 命令和 Workfold 命令。
c:\projects>tf dir /recursive
下列範例會顯示該路徑內所有的 Team Foundation 版本控制伺服器檔案。 "314dir" 子資料夾不需存在於本機資料夾中。
c:\projects>tf dir 314dir
下列範例會顯示 Team Foundation 版本控制伺服器路徑內，標記為 "My label" 的檔案版本。 "314dir" 子資料夾不需存在於本機資料夾中。
c:\projects>tf dir /version:L"My label" 314dir
下列範例顯示 Team Foundation 版本控制伺服器根目錄中的所有資料夾。 本機工作資料夾會被忽略，因為 $/ 代表 Team Foundation 版本控制伺服器路徑。
c:\projects>tf dir /folders $/
下列範例列出 Team Foundation 版本控制伺服器中的每個檔案和資料夾。
c:\projects>tf dir /recursive $/
下列範例列出目前資料夾中的所有項目以及刪除的項目和其刪除 ID。
c:\projects>tf dir /deleted