TeamCity オンプレミス 2026.1 ヘルプ

Visual Studio テスト

Visual Studio テストビルドランナーは、MSTest フレームワークと VSTest コンソールランナーの機能を統合します。両方のフレームワークをサポートしているため、TeamCity はテストを実行し、テスト結果を自動的にインポートできます。

Visual Studio テストランナーには、Visual Studio テストエージェントまたは Microsoft Visual Studio がビルドエージェントにインストールされている必要があります。

Visual Studio テストランナー設定

オプション

説明

テストエンジンの種類

テストの実行に使用されるツールを選択します: VSTest または MSTest。

テストエンジンのバージョン

ドロップダウンメニューからツールのバージョンを選択します。デフォルトでは、使用可能な VSTest および MSTest インストールは TeamCity によって自動検出されます。

  • MSTest バージョン 2005-2017 がサポートされています

  • VSTest バージョン 2012-2017 がサポートされています

ここでもテストランナーへのカスタムパスを指定できます。TeamCity パラメーターがサポートされています。

テストファイル名

このフィールドは VSTest では必須ですが、MSTest ではオプションです。
含まれるアセンブリリストに、テストを実行するアセンブリへのパスの改改行コードリストを指定します。対応するフィールドにアセンブリへのパスを指定して、テスト実行からアセンブリを除外します。ワイルドカードがサポートされています。
アセンブリへのパスは、ビルドチェックアウトディレクトリを基準とした相対パスである必要があります。

実行構成ファイル

(オプション)VSTest(英語) の場合は標準 .runsettings ファイル、MSTtest(英語) の場合は .testsettings ファイルを指定します。ファイルブラウザー VCS-browserIcon.png を使用できます。

追加のコマンドラインパラメーター

選択したテストエンジンの追加のコマンドラインパラメーターを入力します。
MSTest で実行されたテストはオンザフライで報告されないことに注意してください。
Microsoft Developer Network には、VSTest(英語) および MSTest(英語) で使用可能なオプションがリストされています。

その他の設定は、テストを実行するエンジンによって異なります。

VSTest 設定

オプション

説明

ターゲットプラットフォーム

プラットフォームのビット数を選択します。x64 ターゲットプラットフォームを指定すると、vstest.console プロセスは分離モードで実行されます。

フレームワーク

デフォルトが指定されている場合、vstest.console はターゲットフレームワークを自動的に選択します。ドロップダウンを使用して .NET プラットフォームを手動で選択することもできます。

テスト名

(省略可能)含まれているアセンブリで検出されたすべてのテストのうち、指定された値と名前が一致するテストのみが実行されます。複数値の場合は、改行を使用してください。

フィールドが空の場合、すべてのテストが実行されます。詳細は Microsoft のドキュメント(英語)を参照してください。以下のオプションと一緒に使用することはできません。

テストケースフィルター

与えられた式に一致するテストを実行します。詳細は Microsoft のドキュメント(英語)を参照してください。上記のオプションと一緒に使用することはできません。

単独で実行

独立したプロセスでテストを実行する

リアルタイムのテストレポートを使用する

  • このチェックボックスをオンにすると、カスタム TeamCity テストロガーがリアルタイムレポートに使用されます。詳細については、次のセクションを参照してください。

  • 選択しない場合、VSTest は実行後にテストを TeamCity に報告します(カスタムロガーの検出は試行されません)。

カスタムテストロガー

VSTest.Console は、テストの実行時に発生するイベントを処理できるライブラリであるカスタムロガーをサポートしています。
TeamCity には、リアルタイムのテストレポートを提供するカスタムロガーがあります。ロガーは、VSTest.Console の Extensions ディレクトリに dll をコピーする必要があるため、エージェントマシンに手動でインストールする必要があります。カスタムロガーをインストールすると、エージェントを再起動する必要はありません。

カスタムロガーをインストールする :

1\. カスタムロガー(英語)をダウンロードします。

2\. エージェントマシンでダウンロードしたアーカイブの内容を次のパスに抽出します。

  • VisualStudio 2019 アップデートの場合:

PROGRAM_FILES(x86)\Microsoft Visual Studio\2019<Edition>\Common7\IDE\Extensions\TestPlatform\Extensions
  • VisualStudio 2017 アップデート 5 以降の場合:

PROGRAM_FILES(x86)\Microsoft Visual Studio\2017<Edition>\Common7\IDE\Extensions\TestPlatform\Extensions
  • VisualStudio 2017 のアップデート 4 まで:

PROGRAM_FILES(x86)\Microsoft Visual Studio\2017<Edition>\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions
  • VisualStudio 2015 の場合:

PROGRAM_FILES\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions
  • VisualStudio 2013 の場合:

PROGRAM_FILES\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions
  • VisualStudio 2012 の場合:

PROGRAM_FILES\Microsoft Visual Studio 11.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions

3\. エージェントマシンのコンソールで vstest.console.exe /ListLoggers を実行して、カスタムロガーが正しくインストールされていることを確認します。ロガーが正しくインストールされている場合は、FriendlyName が TeamCity のロガーがリストに表示されます。

VSTest.TeamCityLogger.TeamCityLogger Uri: logger://TeamCityLogger FriendlyName: TeamCity{info}

MSTest 設定

オプション

説明

MSTest メタデータ

/testmetadata:file 引数の値を入力します。詳細については、Microsoft のドキュメント(英語)を参照してください。

実行するメタデータからのテストリスト

テストリストを編集します。すべての行は /testlist:line 引数に変換されます。詳細は Microsoft のドキュメント(英語)を参照してください。

テスト

実行する個々のテストの名前このオプションは一連の /test: 引数に変換されます。詳細は Microsoft のドキュメント(英語)を参照してください。

固有

テストセクションで指定されたテストに一意の一致が 1 つ見つかった場合にのみ、テストを実行します。

結果ファイル

/resultsfile:file_name コマンドライン引数の値を入力します。パラメーター参照がサポートされています。ビルドの一時ディレクトリに一時的な \*.trx ファイルを生成するには、フィールドを空白のままにしておくことをお勧めします。ディレクトリはビルド間でクリーンアップされる可能性があることに注意してください。

テスト実行結果を名前付き非デフォルトファイルに保存するには、/resultsfile:file_name コマンドライン引数に値を入力します。

  • 指定されたパスが相対パスの場合、ビルドチェックアウトディレクトリからの相対パスになります。指定されたファイルがチェックアウトディレクトリにすでに存在する場合、ビルドエージェントはファイルの削除を試みます。エージェントが削除に失敗した場合、ビルドは失敗します。
    ビルド一時ディレクトリに *.trx レポートを作成するには、%system.teamcity.build.tempDir%. を使用します

  • 指定されたパスが絶対パスの場合は、「そのまま」使用されます。

2026 年 3 月 08 日

関連ページ:

Docker レジストリ接続

Docker レジストリ接続ビルド機能により、TeamCity はビルドの開始前に DockerHub またはその他のコンテナーレジストリに自動的にサインインできます。この機能を次の場所に追加します。TeamCity による Docker/Podman 操作 (たとえば、および) の監視と検出を許可します。ビルド前に認証されたレジストリに自動的にログインし、ビルド後にログアウトします。ローカル (Docker と Podman の両方) イメージをクリーンアップし、レジストリにプッシュ (Doc...

.NET

TeamCity.NET ビルドステップを使用すると、.NET (Core) および .NET フレームワークを対象とするアプリケーションをビルド、テスト、デプロイできるほか、NuGet パッケージをダウンロードしてプッシュすることもできます。.NET ステップイン構成とパイプライン:クラシックビルド構成では、.NET は、選択したコマンドに応じて設定が変化する単一のビルドステップです。パイプラインでは、これらの各コマンドは個別のビルドステップとして使用できます。エージェント要件:.NET ス...

ビルドパラメーターの設定

パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型:TeamCity は 3 種類のパラメーターをサポートしています。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...

ワイルドカードのサポート

TeamCity はさまざまな設定オプションでワイルドカードをサポートします。Ant のようなワイルドカード:ディレクトリ区切り文字(または)を除く、ファイルまたはディレクトリ名の任意のテキストに一致します。ディレクトリ区切り文字を除く、ファイル名またはディレクトリ名の単一のシンボルに一致します。ディレクトリ区切り文字を含むすべてのシンボルに一致します。Ant ワイルドカードの詳細については、Ant ドキュメントの対応するセクションを参照してください。サンプル現在のディレクトリ内の次のファイル...