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