設定ファイル

Configuration files for UiPath Robot, including UiPath.config and proxy.json, system environment variables, and instructions for restarting components after changes.

Robot のコンポーネントを再起動する

構成ファイルを編集した場合、変更を有効にするには Robot の関連コンポーネントを再起動する必要があります。次のリストに、さまざまなコンポーネントを再起動する方法を、Robot のインストール モードに基づいてまとめています。

保存していない作業が失われることがないよう、再起動する前に必ず進行中の作業を保存してください。

• Robot サービス
  • サービス モードのインストール
    1. [タスク マネージャー] > [サービス] を開きます。
    2. Look for the UiRobotSvc service, named UiPath Robot.
    3. サービスのコンテキスト メニューを開き、[ 再起動] を選択します。
  • ユーザー モードのインストール - Assistant を終了して再起動します。または、以下の手順を実行します。
    1. [タスク マネージャー] > [詳細] を開きます。
    2. UiPath.Service.UserHost.exe プロセスを選択します。
    3. [タスクの終了] を選択します。
• UiPath RobotJS ServiceHost - Service Mode installations with the JavaScript add-on
  1. [タスク マネージャー] > [サービス] を開きます。
  2. UiPath RobotJS Service サービスを探します。
  3. サービスのコンテキスト メニューを開き、[ 再起動] を選択します。
• UiPath Assistant
  1. Assistant で、[設定] を選択して、[終了] を選択します。
  2. Assistant を再起動します。
• ウィジェット - Assistant を再起動します。または、以下の手順を実行します。
  1. タスクバーの Assistant アイコンのコンテキスト メニューを開きます。
  2. [ウィジェットを再読み込み] を選択します。

uipath.config

UiPath.config ファイルには、Robot に不可欠な構成パラメーターが含まれています。管理者は、構成ファイルのパラメーターのリストを編集して、ロボットの動作をカスタマイズできます。

注:

環境ごとに固有の注意が必要な場合があるため、UiPath では、ロボットの現在の環境が開発、ステージング、運用のいずれであっても、その環境に基づいて異なる構成を適用できます。このファイルを編集するときは常に注意してください。設定が間違っていると、アプリケーションに問題が発生することがあります。

重要:

Robot 2025.10 より、プロキシ設定は UiPath.config ではなく proxy.json で行います。詳しくは、「proxy.json」をご覧ください。

ファイルにアクセスする

When you install your Robot, the system creates the UiPath.config file in the Robot installation folder.

To access it, navigate to %ProgramFiles%\UiPathPlatform\Robot\<version>\UiPath.config for a per-machine installation, or %LocalAppData%\Programs\UiPathPlatform\Robot\<version>\UiPath.config for a per-user installation. On update, the UiPath Platform Installer copies your UiPath.config and NuGet.config to the new version folder, so your edits are kept. It then resets Telemetry.Enabled, SkipHttpConfigurationSources and DisableSecureXaml in UiPath.config (and DefaultServiceUrl when SERVICE_URL is set) to the values of its installation parameters, so set those through the installer parameters. It also sets signatureValidationMode in NuGet.config from ENFORCE_SIGNED_EXECUTION and removes the trustedSigners node unless ENFORCE_SIGNED_EXECUTION is true.

カスタマイズ可能な設定

UiPath.config ファイルは、以下のパラメーターで構成されます。

• connectionSettings 構成セクション

  • DefaultServiceUrl (string) - ロボットが Orchestrator に接続するために使用する既定のアドレスを設定します。

    例：

    string DefaultServiceUrl = "https://cloud.uipath.com"
    

  • AutoSignIn (bool) - Assistant の自動サインイン機能を有効化します。既定値は false です。

    例：

    bool AutoSignIn = true.
    

  • EnforceDefaultServiceUrl (bool) - Enforces the address provided as DefaultServiceUrl to all users. Default value is false. Has no effect in Service Mode.

    例：

    bool EnforceDefaultServiceUrl = true.
    

• communicationSettings 構成セクション

  • MaxMessageSizeInMegabytes (byte) - システムが送受信できるメッセージの最大サイズを MB 単位で設定します。既定値は 10 です。

    大きすぎるメッセージを処理することによる過負荷やプロセスのクラッシュを防止するために使用します。

    例：

    byte MaxMessageSizeInMegabytes = 10;
    

  • InstallPackageTimeout (TimeSpan) - パッケージのインストールの制限時間を設定します。既定値は 20 分です。

    パッケージのインストールに定義された時間よりも長い時間がかかる場合、インストールは中止されます。

    例：

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
    

  • RequestTimeout (TimeSpan) - システムが通信の応答を待機する時間を定義します。既定値は 40 秒です。

    設定された時間内に応答を受信しない場合、システムは停止して次の処理に進みます。 これにより、システムのハングアップを防止します。

    例：

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
    

• packageSettings 構成セクション

  • PackagesInstallationFolder (string) - Sets the default directory where packages are installed. Default value is %UserProfile%\.nuget\packages. In Service Mode, the path is expanded for the user that runs each job.

  • SkipHttpConfigurationSources (bool) - Enables the system to ignore package sources configured with an HTTP or HTTPS URL, such as NuGet feeds. Default value is false.

    つまり、システムはこれらのソースからパッケージを取得しません。このため、ソースが信頼できない場合や安全でない場合に便利です。

  • DisableSecureXaml (bool) - 安全でない可能性があるワークフローの実行をロボットに許可します。既定値は false です。

  • DirectDownload (bool) - Stops the Robot from writing downloaded packages to the shared NuGet http-cache disk cache. The Robot still reads files that are already in the cache, and downloads the others every time it needs them. Default value is false.

  • NoCache (bool) - Stops the Robot from reading or writing the shared NuGet http-cache. The Robot uses a temporary folder that it discards instead. Unlike DirectDownload, the in-memory download cache still applies, so each package is downloaded once per restore. Default value is false.

  • PackageSaveWithoutNupkg (bool) - パッケージを .nupkg ファイルなしで保存することを許可します。既定値は false です。

    ダウンロード サイズを減らすのに役立ちます。

• analyticsSettings 構成セクション
  • Telemetry.Enabled (bool) - Allows UiPath to collect and send usage data for analysis. Default value is true. The UiPath Platform Installer sets it from its own telemetry setting when it installs or updates the Robot.
• robotCacheSettings 構成セクション

  • SessionCacheDuration (TimeSpan) - 特定のセッションのデータをキャッシュに保持して破棄するまでの期間を定義します。既定値は 30 秒です。

    変数の値や操作の詳細などのデータを、再作成または再取得するのではなく再利用する場合に便利です。

    例：

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
    

  • GetResourceUrlCacheDuration (TimeSpan) - API や Web ページなどのリソースの URL をキャッシュに保存する期間を定義します。既定値は 1 時間です。

    ロボットが特定のリソースに何度もアクセスする必要がある場合にパフォーマンスを最適化するのに役立ちます。

    例：

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
    

• robotJsSettings 構成セクション

  • ListenerPort (int) - Robot.js が受信接続をリッスンするポート番号を設定します。既定値は 2323 です。

    これにより、Robot サービスは、ローカル サーバーまたはリモート サーバーで実行されている Web アプリケーションと対話できます。

    例：

    int ListenerPort = 2323;
    

  • TokenExpiryInDays (int) - Sets the validity period, in days, of the token that the robot service issues to a web application after the user gives consent. Default value is 30 days.

    例：

    int TokenExpiryInDays = 30;
    

  • AllowUrlList (string) - Sets the web origins (the browser Origin header) whose RobotJS consent dialog the Robot accepts automatically. Separate entries with semicolons. The default list is https://cloud.uipath.com, https://staging.uipath.com, https://alpha.uipath.com, https://govcloud.uipath.us and https://alpha.gov.uipath-dev.com. Setting this key replaces the default list. To add origins without replacing it, use the UIPATH_ROBOTJS_ALLOWLIST system variable.

    例：

    string AllowUrlList = "https://cloud.uipath.com;https://mydomain.com";
    

重要:

• Back up the original UiPath.config file before you change it, so you can restore the original settings.
• UiPath.config ファイルに加えた更新内容を適用するには、UiPath サービスまたはシステムを再起動します。
• UiPath.config ファイルでのローカルの設定は、Orchestrator での設定よりも優先されます。

You can encrypt sensitive data in the UiPath.config file for additional security.

UiPath Robot のシステム変数

システム環境変数を使用して、さらに細かくカスタムの動作を設定できます。

重要:

いずれかのシステム変数を変更したら、Robot サービスを再起動してください。

次のリストは、最も一般的なユース ケースをまとめたものです。

• UIPATH_SESSION_TIMEOUT - 対話型セッションを作成するための既定の 60 秒のタイムアウトを変更します。ロボットが対話するシステムのパフォーマンスと読み込み時間に基づいてロボットの動作を適応させるには、この値を調整します。

  例：

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT - ロボット セッションでプロセスを開始する場合の既定の 180 秒のタイムアウトを変更します。

  例：

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE - Sets the language the Robot operates in. The value is a culture code, not the language name. The supported codes are en, fr, de, es, es-MX, pt, pt-BR, ja, ko, ru, tr, ro, zh-CN and zh-TW. The Robot ignores an unsupported value, such as French, and falls back to the next source. The order of precedence is:

  1. UIPATH_LANGUAGE user environment variable
  2. UIPATH_LANGUAGE machine environment variable
  3. UIPATH_LANGUAGE process environment variable
  4. Current thread UI culture, if supported
  5. UiPath の既定の言語 (英語)

  例：

  UIPATH_LANGUAGE=fr
  

• UIPATH_HEADLESS_WITH_USER - Orchestrator に設定済みの特定のユーザーの資格情報を使用します。

  例：

  UIPATH_HEADLESS_WITH_USER=True
  

• UIPATH_PRE_LOADED_EXECUTOR - 既定では、ロボットの起動時に、事前読み込み済みの Executor が起動します。この動作を変更し、最初のプロセスの実行時にのみ事前読み込み済みの Executor を起動するには、この変数を None に設定します。

  例：

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR - 事前読み込みされた実行機能を無効化します。

  例：

  UIPATH_DISABLE_PRE_LOADED_EXECUTOR=True
  

• UIPATH_ROBOTJS_ALLOWLIST - Robot JS SDK と Robot Executor 間の接続を確立するときに、ロボットの同意ダイアログを自動的に受け入れます。

  The value is a list of origins separated by semicolons. Each origin includes the scheme, for example https://myapp.contoso.com. Add the port only if it is not the default (80 or 443). The Robot also accepts the origins in the AllowUrlList key of the robotJsSettings section of UiPath.config.

  例：

  UIPATH_ROBOTJS_ALLOWLIST=https://cloud.uipath.com;https://mydomain.com
  

• UIPATH_DNS_MACHINENAME - RDP セッションの作成時にローカルホストに DNS ホスト名を使用することを許可します。RDP に Kerberos 認証を使用する環境で無人ジョブを実行するには、この値を True に設定します。

  例：

  UIPATH_DNS_MACHINENAME=True
  

• NUGET_FALLBACK_PACKAGES - フォールバック パッケージ フォルダーへのパスを設定します。複数のパスを区切るには、セミコロンを使用します。

  この変数がない場合、ロボットはフォールバック パッケージ フォルダーを Nuget.config ファイル内で検索します。

• NUGET_SCRATCH - 同じマシン上の複数のユーザー モードの Robot が、パッケージを保存するローカル パスを共有できるようにします。

  この値は、NuGet のインストール フォルダーとは異なるパスにする必要があります。また、これは NuGet の一時フォルダーとして機能します。

  注:

  設定する一時フォルダーは、NUGET_SCRATCH 変数でのみ使用してください。

  例：

  NUGET_SCRATCH=C:\NuGetTempFolder
  

• UIPATH_PRESERVE_CREDENTIALS_CASE - ログ記録用の資格情報の、元の大文字と小文字 (ドメイン\ユーザー名) を保持します。

  例：

  UIPATH_PRESERVE_CREDENTIALS_CASE = True
  

• UIPATH_SESSION_BEHAVIOR - ジョブ完了後のセッション復元動作を設定します。次のオプションが利用できます。

  • TryReuseAndRestoreSession — 既定のオプションです。ジョブの完了後に、セッションを再利用して以前のステートへの復元を試みます。再利用する初期セッションがない場合は、復元時にログオフします。
  • ForceNew — 以前のセッション ステートに関係なく、まったく新しいセッションを作成します。復元時には常にログオフします。
  • LeaveSessionActive — 初期セッション ステートの復元を防止します。
  • LeaveSessionDisconnected — 復元時に常にセッションを切断します。

  例：

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
  

• UIPATH_HTTP_CONNECTION_LIFETIME - Orchestrator への接続を開いたままにする時間を定義します。この時間を過ぎると、接続は閉じられて更新されます。既定の時間は 30 分ですが、この値を調整するには秒単位の値を使用します。

  例：

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600
  

• UIPATH_FILE_LOG_LEVEL - ローカル ファイルで使用される実行ログ レベルを定義します。これは、Orchestrator で使用されるログ レベルとは異なります。次のオプションが利用できます。

  • Verbose
  • Trace (トレース)
  • Information
  • Warning
  • Error
  • Critical
  • Off

  例：

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose
  

• UIPATH_EXECUTOR_STARTUP_DELAY - セッションが作成されてから Executor が起動されるまでの待機時間を秒単位で定義します。インフラストラクチャにおいて、一部のサービス (VPN、セキュリティ) を読み込んでからオートメーションの実行を開始する必要がある場合に使用します。

  例：

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5
  

• UIPATH_MEDIUMPLUS_EXECUTOR - Robot Executor を中+ の整合性レベルで起動し、より高い権限を必要とするウィンドウ (RDP の資格情報の入力時に表示される Windows CredentialBroker ダイアログなど) をオートメーションで操作できるようにします。有効化するには 1 に設定します。ユーザー アカウント制御 (UAC) が有効化された Windows が必要です。詳しくは、「 中 + の整合性への昇格」をご覧ください。

  例：

  UIPATH_MEDIUMPLUS_EXECUTOR=1
  

• UIPATH_MEDIUMPLUS_INVOKE - [ ワークフロー ファイルを呼び出し] アクティビティと [ プロセスを呼び出し ] アクティビティを呼び出しごとに中+ の整合性レベルで実行できるようにします。昇格するには、次の両方の条件が必要です。この変数を有効化 し、 そのアクティビティで昇格をリクエストする必要があります (昇格オプションが有効化されている)。変数だけでは効果がありません。有効化するには、このマシン (システム) 環境変数を 1 に設定します。ユーザー アカウント制御 (UAC) が有効化された Windows が必要です。詳しくは、「 中 + の整合性への昇格」をご覧ください。

  例：

  UIPATH_MEDIUMPLUS_INVOKE=1
  

• UIPATH_APPLY_SERVICE_PROXY - ロボット プロセスを実行するアカウントのプロキシ構成ではなく、マシン レベルの proxy.json ファイルからプロキシを取得します。サービス アカウントにプロキシ構成を保持するためのユーザー プロファイルがない Unattended ロボットを対象としています。ユーザーごとのプロキシ資格情報は読み取られないため、プロキシ proxy.json 基本認証が必要な場合は、これらの資格情報が含まれている必要があります。Robot サービスは常に proxy.json適用されるため、影響を受けません。詳しくは、「 すべてのロボット プロセスにマシンレベルのプロキシを使用する」をご覧ください。

  例：

  UIPATH_APPLY_SERVICE_PROXY=True
  

• UIPATH_VERBOSE_LOG_LIMIT - Executor プロセスごとの Verbose ログの数を制限します。既定値は 10000です。制限に達すると、ロボットは警告をログに記録し、今後の Verbose ログを削除します。0 以下の値は無視され、代わりに既定値が使用されます。

  制限にカウントされるのは、アクティビティの実行中にロボットが生成するログのみです。オートメーションがログに記録すること自体が影響を受けないメッセージ単独で呼び出されるワークフローは、専用の Executor プロセスで実行されるため、専用の制限があります。

  例：

  UIPATH_VERBOSE_LOG_LIMIT=5000
  

proxy.json

The proxy.json file stores proxy configuration for the Robot Service when running in service mode. Available starting with Robot 2025.10, it replaces proxy settings that were previously maintained in UiPath.config.

重要:

Robot 2025.10 より、プロキシ設定は proxy.json で行います。

ファイルにアクセスする

ファイルの場所: %ProgramData%\UiPath\Shared\proxy.json

注:

以前のバージョンから更新する際に、すでにプロキシが設定されている場合、既存の設定は自動的に proxy.json に移行されます。

proxy.json の編集後、変更を有効にするために Robot サービスまたはデバイスを再起動します。

注:

The Robot ignores a proxy.json file that is not owned by the built-in Administrators group or the local system account. The Robot Service moves such a file aside as proxy.json.old.

パラメーター

次のパラメーターがサポートされています。ScriptAddressとProxyAddressの両方が同じファイルに存在する場合、ScriptAddress優先されます。

パラメーター	入力	説明
ScriptAddress	文字列	プロキシ自動構成 (PAC) スクリプトの URL です。存在する場合、ProxyAddress よりも優先されます。例: http://proxy.address/proxy.pac
ProxyAddress	文字列	プロキシ サーバーのアドレスとポートです。例: http://proxy.address:1234/
BypassLocalAddresses	Boolean	true の場合、ローカル アドレスはプロキシ サーバーをバイパスします。
BypassList	文字列	プロキシをバイパスするホストを指定する正規表現パターンをセミコロンで区切ったリストです。正規表現の特殊文字をエスケープするには、\\ を使用します。例: server\\.domain\\.local$;192\\.168\\.\\d{1,3}\\.\\d{1,3}
UserName	文字列	基本プロキシ認証用のユーザー名です。
Password	文字列	基本プロキシ認証のパスワードです。
Domain	文字列	プロキシ基本認証のドメインです。

設定例

ステップバイステップの設定手順については、「Robot をプロキシ サーバー経由でリダイレクトする」をご覧ください。

PAC スクリプト

{
  "ScriptAddress": "http://proxy.address/proxy.pac"
}

基本認証のプロキシ アドレス

{
  "ProxyAddress": "http://proxy.address:1234/",
  "BypassLocalAddresses": true,
  "BypassList": "server\\.domain\\.local$;www.example.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
  "UserName": "myUser",
  "Password": "<your-password>",
  "Domain": "myDomain"
}