TeamCity On-Premises 2026.2 Help

C# スクリプト

C# スクリプトランナーを使用すると、Windows、Linux、macOS で C# スクリプトを実行できます。 複数のプラットフォームで C# 対話シェルを実行するためのカスタム TeamCity ツールを使用します。

このランナーを使用すると、ビルド環境の準備、OS ユーザーの作成、さまざまなメッセンジャーへのレポートなど、さまざまなサービスタスクを実行できます。

一般的なビルドステップの設定については、 ビルドステップの設定を参照してください。 このステップをコンテナー内で実行する方法については、 コンテナーラッパー を参照してください。

前提条件

ランナーの要件:

  • .NET ランタイム 6.0.0 以降がビルドエージェントにインストールされているか、このステップが Docker 内で実行される場合は Docker コンテナーで利用可能である必要があります。

  • TeamCity.csi パッケージは、 エージェントツールとしてインストールされている必要があります。

C# スクリプト設定

設定

説明

TeamCity C# スクリプトツール

管理 | ツール 経由でインストールされた TeamCity C# スクリプトツールのバージョンを選択するか、 ビルドチェックアウトディレクトリを基準としたこのツールへのカスタムパスを入力します。

スクリプトタイプ

二つのオプションのいずれかを選択します: ランナー内でカスタムスクリプト本文を直接入力するか、C# スクリプトファイルへのパス (.csx) を指定します。

C# スクリプト

カスタムスクリプト タイプで使用できます

C# スクリプトのコードを入力します。

C# スクリプトファイル

スクリプトファイル タイプで使用できます

スクリプトファイルへのパスを、 ビルドチェックアウトディレクトリを基準にして入力します。

スクリプトパラメーター

スクリプトのパラメーターを入力します。 パラメーターは 引数者向けなら 配列として渡されます。 サポートされている引数を表示します。

パラメーター参照がサポートされています。

NuGet パッケージソース

スクリプトから パッケージを参照する場合、TeamCity はこのフィールドで指定されたフィードからそのパッケージを自動的にダウンロードします。 ランナーは、 #r "nuget:System.Text.Json"#r "nuget:System.Text.Json,4.7.2" などのコマンドを自動的に解析できます。

デフォルトでは、TeamCity は NuGet.org で公開されたソースから NuGet パッケージを復元します。 このフィールドでは、他の NuGet リポジトリへのパスを指定でき、TeamCity は宣言の順序に従ってそこでパッケージを検索します。 指定されたリポジトリのいずれにもパッケージソースが見つからない場合、TeamCity は NuGet.org で検索します。

プライベートリポジトリにアクセスできるようにするには、 NuGet フィード資格情報を設定します。

TeamCity 内部フィードを参照することもできます。

スクリプトでサポートされるコマンドと引数

サポートされているコマンド:

コマンド

説明

サンプル

#r

NuGet パッケージまたはアセンブリとその依存関係への参照を追加します。

#r "nuget:<パッケージ名>, 1.2.3" または #r "<ライブラリ名>.dll"

#load

指定されたスクリプトファイルをロードして実行します。

#load "<スクリプト名>.csx"

#help

使用可能なコマンドとキーバインディングに関するヘルプを表示します。

#l

詳細レベルを quietnormaltrace に設定します。

サポートされている引数:

  • スクリプトパラメーターフィールドに提供され、 引数者向けなら 配列に格納される 引数 (たとえば、最初のスクリプトパラメーターの値を書き込む場合は WriteLine(Args[0]))。

  • システムパラメータービルド構成設定 | パラメーター で指定され、 Props ディクショナリに格納されます (たとえば、 WriteLine(Props["version"])system.version パラメーターの値を書き込むために使用します)。

2026 年 9 月 11 日