このページは、dottestcli のコマンド ライン オプションの一覧です。

テスト コンフィギュレーションの設定

-config <config_url>

解析に使用するテスト コンフィギュレーションです。オプションの後にビルトイン、ユーザー定義、または DTP に格納されたチーム コンフィギュレーションを指定します。

例:

• dottestcli -config "builtin://Critical Rules"
• dottestcli -config "user://My_Config"
• dottestcli -config "dtp://New_Rules"

-listConfigs

 詳細については「テスト コンフィギュレーションの設定」を参照してください。

入力スコープの設定

-solution <path>

解析するプロジェクトのパスを  (.sln または .slnx フォーマットで) 指定します。Ant スタイルのワイルドカードを使用してパターンを指定できます。

例:

• -solution "C:\Devel\FooSolution\FooSolution.sln"

同じコマンドラインでこのオプションを複数回使用して、複数のソリューションを指定できます。

-project <path>

ソリューションが提供されない場合に、解析するプロジェクトのパスを指定します。Ant スタイルのワイルドカードを使用してパターンを指定できます。

例:

• -project "C:\Devel\FooSolution\FooProject.csproj"

同じコマンドラインでこのオプションを複数回使用して、複数のプロジェクトを指定できます。

-website <path>

ソリューションが提供されない場合に、解析する Web サイトのディレクトリを指定します。

例:

• -website "C:\Devel\MyWebsite"

同じコマンドラインでこのオプションを複数回使用して、複数のリソースを指定できます。

-solutionConfig

ソリューション構成を指定します。

例:

• -solutionConfig Debug

-projectConfig

ソリューション構成を指定します。

例:

• -projectConfig Debug

-targetPlatform

ソリューション (またはプロジェクト) のターゲット プラットフォームを指定します。

例:

• -solution "C:\Devel\FooSolution\FooSolution.sln" -solutionConfig Debug -targetPlatform "Any CPU"
• -project "C:\Devel\FooSolution\FooProject.csproj" -projectConfig Debug -targetPlatform AnyCPU

-resource <path relative to the solution>

-solution、-project、および -website オプションで定義されたプライマリ テスト スコープを絞り込みます。以下のいずれかを指定できます。

• ソリューション内のプロジェクトへのパス
• プロジェクト内のファイルのディレクトリへのパス
• ファイルへのパス

同じコマンドラインでこのオプションを複数回使用して、複数のリソースを指定できます。Ant スタイルのワイルドカードを使用してリソースを指定できます。

例:

• -resource "FooSolution/MyProject1"
• -resource "FooSolution/MyProject1/QuxDirectory"
• -resource "FooSolution/MyProject1/QuxDirectory/BazFile.cs"

-include <絶対パス> および -exclude <絶対パス>

-solution、-project、および -website オプションで定義されたプライマリ テスト スコープを絞り込みます。Ant スタイルのワイルドカードを使用してリソースを指定できます。

例:

• -exclude "C:/Devel/FooSolution/*.Tests/**/*.*"
• -include "C:/ProductX/Solution1/src"

-reference <path>

解析対象プロジェクトの依存関係を解決するのに必要な追加のアセンブリへのパスを指定します。「Unable to find reference assembly」というメッセージが表示された場合、このオプションを使用してください。Ant スタイルのワイルドカードと現在の作業ディレクトリへの相対パスを使用できます。

例:

• -reference C:\MySolution\ExternalAssemblies\*.dll
• -reference C:\Solution1\Assemblies2018\*.exe
• -reference C:\FooSolution\Ext\**\*.dll

-testTagFilter

単体テストと開発成果物 (バグ、タスク、フィーチャー リクエストなど) を関連付ける課題トラッキング タグを指定し、テスト実行の範囲を限定します。オプションが設定されている場合、dotTEST は -testTagFilter オプションで指定された開発成果物と関連付けられたテストだけを実行します。次のフォーマットで、課題タイプの後に 1 つまたはそれ以上の成果物 ID を指定します。

-testTagFilter <type>=<ID>

複数の -testTagFilter オプションを指定できます。

例:

• -testTagFilter "task=123"
• -testTagFilter "task=123, 456, 789, 334"
• -testTagFilter bug="123, 667" -testTagFilter "fr=229"

課題トラッキング タグについては「テストと開発成果物との関連付け」を参照してください。

詳細については「単体テストの実行」を参照してください。

追加のコンポーネントのインストール

-installAnalyzer <name;path>

 カスタム ルールを含む外部の Roslyn アナライザーをインストールします。以下のいずれかを指定できます。

• 次のフォーマットで記述したアナライザーの名前とパス: name;path
• アナライザーのリストを含む .lst ファイルへのパス。ファイルの各エントリは次のフォーマットで記述する: name;path

例:

• -installAnalyzer MyAnalyzerName;"F:\Roslyn Analyzers\MyAnalyzerName.dll"
• -installAnalyzer "F:\Roslyn Analyzers\analyzers.lst"

例 - アナライザーのリスト:

MyAnalyzerName1;F:\Roslyn Analyzers\MyAnalyzerName1.dll

MyAnalyzerName2;F:\Roslyn Analyzers\MyAnalyzerName2.dll

MyAnalyzerName3;F:\Roslyn Analyzers\MyAnalyzerName3.dll

-uninstallAnalyzer <name>

外部の Roslyn アナライザーをアンインストールします。以下のいずれかを指定できます。

• アナライザーの名前
• 次のフォーマットで記述したアナライザーの名前とパス: name;path
• アナライザーのリストを含む .lst ファイルへのパス。ファイルの各エントリは次のフォーマットで記述する: name;path

例については「-installAnalyzer」を参照してください

レポート

-report <path>

レポートが作成されるディレクトリへのパスを指定します。

-publish

結果を DTP に送信します。「DTP への結果の送信とソース コードのパブリッシュ」を参照してください。

コンフィギュレーションのカスタマイズ

-settings <path>

カスタマイズされた設定を含む .properties カスタム ファイルへのパスを指定します。フォーマットは key=value です (例: report.format=pdf)。このオプションを複数回使用して、複数の .properties ファイルを指定できます。同じキーのエントリは上書きされます。 

例:

• -settings Project1Config.properties

プロキシの使用がサポートされています。

-property <key>=<value>

このオプションを使用すると、直接コマンドラインで 1 個の設定を指定できます。  次の形式を使用します: key=value。

このオプションを複数回使用して、同じコマンドラインで複数の設定を指定できます。同じキーを持つエントリは上書きされます。

例:

• -property session.tag=sa_linux -property report.dtp.publish=true -property techsupport.create.on.exit=true

-showSettings

指定できるオプションの一覧は「設定リファレンス」を参照してください。

カバレッジの収集

-staticCoverage

静的なカバレッジ データを含む coverage.xml ファイルへのパスを指定します。

-runtimeCoverage

カバレッジ エージェントを使用して実行されたテストから収集されたカバレッジを含む実行時カバレッジ データ ファイルへのパスを指定します。また、複数のテスト セッションからの複数のカバレッジ データ ファイルを含むフォルダーへのパスを指定できます。

詳細については「アプリケーション カバレッジ」を参照してください。

テスト影響分析の設定

-referenceReportFile

テスト影響分析 (影響を受けるテストだけを実行する) のベースラインとなる最新の実行のデータを含む参照 report.xml ファイルへのパスを指定します。

-referenceCoverageFile

テスト影響分析 (影響を受けるテストだけを実行する) のベースラインとなる最新の実行のデータを含む参照 coverage.xml ファイルへのパスを指定します。

その他のオプション

-machineId

マシン ID を出力します。

-language

dotTEST 実行の UI 言語を指定します。

• 中国語の場合 zh-CN
  
• 日本語の場合 ja-JP

-encodePass <your password>

-noBuild

ソリューションまたはプロジェクトのビルド フェーズをスキップします。

-out <path>

コンソール出力が保存されるファイルへのパスを指定します。

-fail

指摘事項またはセットアップの問題がレポートされた場合、ゼロ以外の終了コードを返し、コマンドを失敗させます (プロセスが失敗したときに返される終了コードについては「コマンドラインの終了コード」を参照してください)。

-version

使用している Parasoft ツールのバージョンに関する情報を出力します。

-help

コマンドラインヘルプを出力します。