View コマンド
更新 : 2007 年 11 月
view コマンドは、ファイルの特定のバージョンを、コンピュータ上の一時フォルダに取得して表示します。
必要なアクセス許可
view コマンドを使用するには、[読み取り] のアクセス許可が [許可] に設定されている必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。
tf view [/server:servername] [/console] [/recursive]
[/shelveset:shelvesetname[;owner]] [/noprompt] itemspec
[/version:versionspec]
パラメータ
引数 |
説明 |
|---|---|
servername |
/server オプションにユーザーが指定した値。例: teamserver2。 |
shelvesetname [:owner] |
シェルブセットを指定します。省略可能な owner 引数は、現在のユーザーが所有していないシェルブセットを指定するときに使用します。 |
Itemspec |
取得するファイルまたはフォルダを指定します。Team Foundation で itemspecs を解析してスコープ内にある項目を確認する方法の詳細については、「コマンド ライン オプション」を参照してください。 |
Versionspec |
/version オプションに、C3 などの値を指定します。Team Foundation でバージョン仕様を解析してそのスコープ内にある項目を確認する方法の詳細については、「コマンド ライン構文 (Team System)」を参照してください。 |
オプション |
説明 |
|---|---|
/server |
Team Foundation Server を指定します。ワークスペースに割り当てられていないディレクトリからコマンドを呼び出す場合は、このオプションを指定する必要があります。 |
/console |
ファイルの出力先をコンソールに指定します。このオプションが便利なのは、コンソールのリダイレクションを使ってファイルをディスクに書き出す場合です (別の名前で書き出したり、バージョンが付けられる項目とは別の場所に書き出すことができます)。 |
/recursive |
指定されたディレクトリとサブディレクトリ内のすべての項目を表示します。 |
/shelveset |
シェルブセットを名前で指定します。 |
/noprompt |
複数のファイルに一致するワイルドカードを itemspec で指定した場合、Team Foundation は、各ファイルを表示するまでメッセージが表示されないようにします。 |
/version |
表示するために開くファイルのバージョンを指定します。このオプションを省略した場合、view コマンドは Team Foundation バージョン管理 サーバーにある最新バージョンを取得します。 |
解説
tf コマンド ライン ユーティリティの view コマンドは、ファイルの読み取り専用コピーを Team Foundation バージョン管理 サーバーからコンピュータ上の一時フォルダに取得し、その内容を表示します。特定のバージョンを指定しない場合、Team Foundation はファイルの最新バージョンを Team Foundation バージョン管理 サーバーから取得します。
view コマンドは、ワークスペースにファイルを取得したり、ファイルをチェックアウトしたりすることはありません。ファイルの Team Foundation バージョン管理 サーバーのバージョンを取得したり、ファイルをチェックアウトする方法の詳細については、「Get コマンド」および「Checkout コマンドと Edit コマンド」を参照してください。
Difference コマンドを使用すると、ファイルの 2 つのバージョン間の相違点を表示できます。
tf コマンド ライン ユーティリティの使い方の詳細については、「Tf コマンド ライン ユーティリティのコマンド」を参照してください。
出力オプション
既定では、Team Foundation ではそのファイルの種類に関連付けられたビューアでファイルの内容が表示されます。
/console オプションを使用した場合、Team Foundation によりファイルの内容がコマンド コンソールに出力されます。同様に、指定されたファイルの種類のビューアを Team Foundation が見つけることができない場合、ファイルの内容はコマンド コンソールに出力されます。
最後に、| または > を使用すると、ファイルの内容を標準出力にリダイレクトして、その内容を別のファイルに保存したり、別のプログラムに渡して事後処理を行ったりできます。
例
次の例は、ファイル 314.c の最新バージョンを表示します。
c:\projects>tf view 314.c
次の例は、変更セット 1999 を使用してチェックインされた 314.c のバージョンを表示します。
c:\projects>tf view /version:C1999 314.c
次の例は、314.c のバージョン 5 を取得し、それをファイル 314.old に書き込みます。
c:\projects>tf view /version:5 314.c > 314.old
次の例は、ワイルドカード "*.cs" に一致する各ファイルの最新バージョンを表示します。
c:\projects>tf view *.cs