VSPerfCmd

U

リダイレクトされたコンソール出力は Unicode として書き込まれます。最初に指定する必要があります。

Output:filename

出力ファイル名を指定します。

User:[domain\]username

START オプションと一緒に使用します。指定したアカウントからモニタへのクライアント アクセスを許可します。

Counter:cfg

サンプル プロファイリング方式を使用するときは、CPU カウンタとサンプリング間隔として使用するイベントの数を指定します。サンプリングできるカウンタ値は 1 つだけです。

インストルメンテーション プロファイリング方式を使用するときに、各インストルメンテーション ポイントで収集する CPU カウンタを指定します。複数の Counter オプションを指定すると、複数のカウンタ データを収集できます (インストルメンテーションのみ)。

カウンタ (cfg) データを指定するには、次の構文を使用します。

CounterName[,Reload[,FriendlyName]]

• CounterName は、VSPerfCmd /QueryCounters コマンドによって返されるカウンタの名前です。

• Reload は、カウンタ イベントのサンプリング間隔です。インストルメンテーション方式を使用する場合、Reload は無視されます。

• FriendlyName (省略可能)。指定すると、プロファイリング ツール のビューおよびレポートの CounterName 値を置き換えます。

WinCounter:path

マーク データを使用する Windows パフォーマンス カウンタを指定します。path は、PDH カウンタ パス形式で記述した Windows パフォーマンス カウンタ文字列です。次に例を示します。

\Processor(0)\% Processor Time

\System\Context Switches/sec

Events:option

EVENTS オプションは、イベント トレース ウィンドウ (ETW) イベント コレクションを制御します。収集されるデータは ETW プロバイダによって提供されます。option の書式は次のとおりです。

<on | off>, <guid>[,flags[,level]]

<on | off>, <provider name>[,flags[,level]]

guid - プロバイダ コントロール GUID。または、プロバイダ名が WMI に登録されている場合は GUID の代わりにプロバイダ名を指定することもできます。

flags - '0x' をプレフィックスとして持つ、16 進のフラグ値。この値はイベント プロバイダによって定義されます。詳細については、ETW プロバイダのドキュメントを参照してください。

level - 収集する情報の量を指定します。この値はイベント プロバイダによって定義されます。詳細については、ETW プロバイダのドキュメントを参照してください。

重要 :

CLR ETW イベントを有効にした場合は、追加のスタートアップ データも TraceView レポートに収集されます。レポートにスタートアップ イベントが出力されないようにするには、次のコマンドを使用します。 C:\<path>VSPerfCmd -events on, \".NET Common Language Runtime\", 0x7fffffff, 5 Managed Object Format (MOF) ファイルにスタートアップ イベントがリストされていないという理由でスタートアップ イベントを除外しなかった場合、これらのイベントはレポート内で GUID として表示されます。詳細については、「Sample Managed Object Format (MOF) File」を参照してください。

さらに、EVENTS オプションは、次の共通のカーネル オプションを認識します。

on, option[,option]

option は次のいずれかになります。

Process - プロセス イベント

Thread - スレッド イベント

Image - イメージの読み込み/アンロード イベント

Disk - ディスク I/O イベント

File - ファイル I/O イベント

Hardfault - ハード ページ フォールト

Pagefault - ソフト ページ フォールト

Network - ネットワーク イベント

Registry - レジストリ アクセス イベント

カーネル プロバイダは、有効化のみが可能です。カーネル プロバイダは、モニタがシャットダウンするまでは無効にしたりそのフラグを変更したりすることはできません。

ShutDown[:n]

監視対象のアプリケーションが終了またはデタッチするのを待ち、その後 VSPerfMon.exe を終了して、完全にシャットダウンするまで待機します。n を指定した場合、VSPerfCmd は最大で n 秒間待機します。n を指定しなかった場合、VSPerfCmd は無期限に待機します。これにより、バッチ プロセスの一部として VSPerfCmd を利用することが容易になります。

GlobalOff

GLOBALOFF オプションはすべてのプロファイリングを無効にします。データは収集されません。このオプションは、パフォーマンス セッションをシャットダウンしません。このオプションを使用すると、アプリケーションのスタートアップ フェーズまたは初期化フェーズでのデータの収集を回避できます。

不適切なデータを収集しないようにするには次のようにします。

ProcessOff:pid

PROCESSOFF オプションは、プロセス ID (pid) を使用して特定のプロセスのプロファイリングとデータ収集を停止します。他のプロセスまたはスレッドは、データの収集を続行します。このオプションは、プロセスが特定の状態に達する前にデータの収集を停止する場合に便利です。プロセスが特定の状態に達した後は、PROCESSON オプションを使用してデータ収集を開始できます。内部的に、PROCESSOFF オプションは、指定されたプロセスの開始/停止数を 0 に設定します。

ThreadOff:tid

THREADOFF オプションは、スレッド ID (tid) を使用して特定のスレッドのプロファイリングとデータ収集を停止します。

他のプロセスまたはスレッドは、データの収集を続行します。このオプションは、スレッドが特定の状態に達する前にデータの収集を停止する場合に便利です。スレッドが特定の状態に達した後は、THREADON オプションを使用してデータ収集を開始できます。内部的に、THREADOFF オプションは、指定されたスレッドの開始/停止数を 0 に設定します。

このオプションは、トレース モードでだけ有効です。

Args:引数

起動するアプリケーションの引数。

Attach:PID[,PID]

サンプル ベースのプロファイラを指定されたプロセス ID (pid or process name) にアタッチします。

Detach

サンプル ベースのプロファイラをすべてのプロセスからデタッチします。

PF[:n]

n 番目のページ フォールトごとにサンプリングを行います (既定 = 10)。

Timer[:n]

n 番目のサイクルごとにサンプリングを行います (既定 = 10000000)。

Admin:Security, List

プロファイリング サービスの現在の状態を示し、ユーザーのアクセス権を一覧表示します。

Admin: <Service|Driver>AutoStart <ON|OFF>

再起動後の、プロファイリング サービス (サービス) またはカーネル モード デバイス ドライバ (ドライバ) の自動的な開始を有効または無効にします。