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>
情報を表示する 1 つ以上のファイルまたはフォルダーを含むプロジェクト コレクションの URL (例: http://myserver:8080/tfs/DefaultCollection/)。
Options
オプション
説明
/version
TFVC で特定のバージョンのファイルとフォルダーのみが表示されるように指定します。
/recursive
指定されたディレクトリのすべてのファイルとサブフォルダーを表示します。
/folders
フォルダーのみを表示します。
/deleted
削除された項目と既存の項目を表示します。 削除された項目の後には ;Xn が続きます。ここで、n は削除 ID です。
/login
Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。
/collection
プロジェクト コレクションを指定します。
解説
dir コマンドの動作対象は、ローカル コピーではなく、ファイルの Azure DevOps サーバー コピーです。 このコマンドで、ローカルのマップされたフォルダーを使用して、適切な Azure DevOps サーバー パスを見つけます。 このコマンドを使用して、Azure DevOps サーバーを探索し、取得する必要があると思われるファイルを特定します。
tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
例
次の例では、ファイル、フォルダー、サブフォルダー、および c:\projects がマップされている Azure DevOps サーバー フォルダー内のファイルの一覧を表示します。 項目の数も一覧表示されます。 作業フォルダーのマッピングを表示および編集する方法の詳細については、「Workspace コマンド」と「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 $/
次の例では、削除された項目とその削除 ID を含め、現在のフォルダー内のすべての項目を一覧表示します。
c:\projects>tf dir /deleted