View コマンド (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>
/version オプションに C3 などの値を指定します。 TFVC がバージョン指定を解析してそのスコープ内の項目を判別する方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
<username>
/login オプションに値を指定します。 この値は、DOMAIN\<username> または <username> として指定できます。
<password>
/login オプションに値を指定します。
<local-file>
出力ファイル フォルダーへのパスを指定します。
Options
オプション
説明
/console
ファイル出力をコンソールに送る必要があることを指定します。 このオプションは、コンソール リダイレクトを使用してディスクにファイルを書き込みますが、バージョン管理された項目とは異なる名前または場所を使用する場合に便利です。
/recursive
指定されたディレクトリとすべてのサブディレクトリ内の項目を表示します。
/shelveset
シェルブセットを名前で指定します。
/noprompt
<item-spec> 引数に複数のファイルと一致するワイルドカード式を含めた場合に、各ファイルを表示する前に TFVC からプロンプトが表示されないように指定します。
/version
表示するために開くファイルのバージョンを指定します。 このオプションを省略して view を使用すると、最新バージョンの Azure DevOps サーバーが取得されます。
/collection
プロジェクト コレクションを指定します。
/login
Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。
/output
Windows シェルを呼び出してファイルを開くのではなく、ローカル フォルダーにファイルを出力します。
解説
tf コマンドライン ユーティリティの view コマンドを使用して、Azure DevOps サーバーからファイルの読み取り専用コピーを取得し、ファイルをコンピューター上の一時フォルダーに保存し、ファイルの内容を表示します。 特定のバージョンを指定しない限り、TFVC では Azure DevOps サーバーから最新バージョンのファイルを取得します。
view コマンドでは、ワークスペースへのファイルの追加やファイルのチェックアウトはできません。ファイルの Azure DevOps サーバー バージョンを取得して、そのファイルをチェックアウトする方法の詳細については、「Get コマンド」および Checkout と Edit コマンドに関する記事を参照してください。
difference コマンドを使用すると、ファイルの 2 つのバージョンの違いを確認できます。 詳細については、「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
次の例では、314.cs のバージョン 5 を取得して、ファイル 314.old に書き込みます。
c:\projects>tf view /version:5 314.cs > 314.old
次の例では、ワイルドカード式 *.cs と一致する各ファイルの最新バージョンを表示します。
c:\projects>tf view *.cs