robot
2024.10
true
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。
UiPath logo, featuring letters U and I in white

Robot 管理ガイド

最終更新日時 2024年12月18日

設定ファイル

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

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

コンポーネント

サービス モードのインストール

ユーザー モードのインストール

Robot サービス

  1. [タスク マネージャー] > [サービス] を開きます。

  2. UiPathRobotSvc サービスを探します。
  3. サービスを右クリックし、[再起動] を選択します。

  1. Assistant を終了して再起動します。

OR

  1. [タスク マネージャー] > [詳細] を開きます。

  2. UiPath.Service.UserHost.exe プロセスを選択します。
  3. [タスクの終了] を選択します。

更新サービス

  1. [タスク マネージャー] > [サービス] を開きます。

  2. UiPath.UpdateService.Agent サービスを探します。
  3. サービスを右クリックし、[再起動] を選択します。

UiPath RobotJS ServiceHost

  1. [タスク マネージャー] > [サービス] を開きます。

  2. UiPath.RobotJS.ServiceHost サービスを探します。
  3. サービスを右クリックし、[再起動] を選択します。

UiPath Assistant

  1. Assistant で、[設定] を選択して、[終了] を選択します。

  2. Assistant を再起動します。

ウィジェット

  1. Assistant を再起動します。

OR

  1. タスクバーの Assistant のアイコンを右クリックします。

  2. [ウィジェットを再読み込み] を選択します。

uipath.config

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

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

ファイルにアクセスする

Robot をインストールすると、UiPath.config ファイルが作成されます。
ログにアクセスするには、C:\Program Files\UiPath\Studio\UiPath.config に移動します。

カスタマイズ可能な設定

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

構成セクション

データ型 + パラメーター名

説明

既定 (Default)

connectionSettings

文字列 DefaultServiceUrl

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

NA

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

Assistant の自動サインイン機能を有効化します。

bool AutoSignIn = true.bool AutoSignIn = true.
bool EnforceDefaultServiceUrl

DefaultServiceUrl で指定したアドレスをすべてのユーザーに適用します。

bool EnforceDefaultServiceUrl = true.bool EnforceDefaultServiceUrl = true.
communicationSettingsbyte MaxMessageSizeInMegabytes

システムが送受信できるメッセージの最大サイズを MB 単位で設定します。

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

10 MB

byte MaxMessageSizeInMegabytes = 10;byte MaxMessageSizeInMegabytes = 10;
TimeSpan InstallPackageTimeout

パッケージのインストールの制限時間を設定します。

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

TimeSpan として表されます。

20 分

TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
TimeSpan RequestTimeout

システムが通信の応答を待機する時間を定義します。

設定された時間内に応答を受信しない場合、システムは停止して次の処理に進みます。

これにより、システムのハングアップを防止します。

TimeSpan として表されます。

40 秒

TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettings文字列 PackagesInstallationFolder

パッケージをインストールする既定のディレクトリを設定します。

C:\UiPath\Packages 
bool SkipHttpConfigurationSources

HTTP 上に設定されているパッケージ ソース (NuGet フィードなど) をシステムが無視できるようにします。

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

 
bool DisableSecureXaml

安全でない可能性があるワークフローの実行をロボットに許可します。

 
bool DirectDownload

ユーザーへの確認なしにパッケージを直接ダウンロードすることを許可します。

 
bool PackageSaveWithoutNupkg
パッケージを .nupkg ファイルなしで保存することを許可します。

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

 
analyticsSettingsbool Telemetry.Enabled

UiPath が分析のために使用状況データを収集および送信することを許可します。

 
webProxySettings文字列 ScriptAddress

プロキシを使用する方法とタイミングを決定するスクリプトのアドレスを設定します。

  
文字列 ProxyAddress

プロキシ サーバーのアドレス (IP またはドメイン名) を設定します。

  
文字列 BypassList

プロキシ サーバーをバイパスしてインターネットに直接接続するアドレスのリストを含みます。

  
bool BypassLocalAddresses

プロキシ サーバーをバイパスして、ローカル アドレスへの直接接続を許可します。

 
文字列 UserName

プロキシ サーバー認証用の資格情報のユーザー名を設定します。

  
文字列 Passwordプロキシ サーバー認証用のユーザー名に関連付けられたパスワードを設定します。  
文字列 Domain認証に必要な、プロキシ サーバーが存在するドメインを設定します。  
robotCacheSettingsTimeSpan SessionCacheDuration

特定のセッションのデータをキャッシュに保持して破棄するまでの期間を定義します。

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

TimeSpan として表されます。

30 秒

TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
TimeSpan GetResourceUrlCacheDuration

API や Web ページなどのリソースの URL をキャッシュに保存する期間を定義します。

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

TimeSpan として表されます。

1 時間

TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettingsint ListenerPort

Robot.js が受信接続をリッスンするポート番号を設定します。

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

2323

int ListenerPort = 2323;int ListenerPort = 2323;
int TokenExpiryInDays

Robot サービスによって生成される認証トークンの有効期間を日数で設定します。

Robot サービスは、他のソフトウェア コンポーネントやサービスと対話する際にこれらのトークンを使用して自身を認証します。

30 日

int TokenExpiryInDays = 30;int TokenExpiryInDays = 30;
文字列 AllowUrlList

Robot サービスがアクセスできる URL のリストを設定します。

Robot サービスが承認されたサービスとのみ対話するようにするのに役立ちます。

 
string AllowUrlList = "https://cloud.uipath.com";string AllowUrlList = "https://cloud.uipath.com";
重要:
  • 変更を加える前に、必ず元の UiPath.config ファイルのバックアップを作成してください。問題が発生した場合に元の設定を復元するのに役立ちます。
  • UiPath.config ファイルに加えた更新内容を適用するには、UiPath サービスまたはシステムを再起動します。
  • UiPath.config ファイルでのローカルの設定は、Orchestrator での設定よりも優先されます。
  • UiPath.config ファイル内の機密データを暗号化してセキュリティを強化できます。

UiPath Robot のシステム変数

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

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

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

システム変数

使用状況

UIPATH_SESSION_TIMEOUT対話型セッションを作成する場合の既定の 60 秒のタイムアウトを変更します。

ロボットが対話するシステムのパフォーマンスと読み込み時間に基づいてロボットの動作を適応させるには、この値を調整します。

UIPATH_SESSION_TIMEOUT=75UIPATH_SESSION_TIMEOUT=75
UIPATH_PIP_SESSION_TIMEOUT

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

UIPATH_PIP_SESSION_TIMEOUT=60UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_USER_SERVICE_PATHユーザー サービスのインストール パスを設定します。
UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exeUIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
UIPATH_LANGUAGE

ロボットが動作する言語を設定します。

言語は次の順序で決定されます。

  1. UIPATH_LANGUAGE 件の値
  2. マシンの環境変数

  3. 現在のスレッドの UI の言語設定

  4. UiPath の既定の言語 (英語)

UIPATH_LANGUAGE=FrenchUIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER

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

UIPATH_HEADLESS_WITH_USER=TrueUIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR

By default, a preloaded executor is launched when the Robot starts.

To change this behavior and launch the preloaded executor only when the first process runs, set this variable to None.
UIPATH_PRE_LOADED_EXECUTOR=NoneUIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR

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

UIPATH_DISABLED_PRE_LOADED_EXECUTOR=TrueUIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST

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

The variable accepts custom application URLs, separated by semicolons. Include the port number in the URL if it differs from the standard ports (80 or 443).

UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_DNS_MACHINENAME

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

UIPATH_DNS_MACHINENAME=TrueUIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

ロボットが Windows 資格情報を認証に使用するプロキシ構成を処理できるようにします。

UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=TrueUIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES

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

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

Allows multiple User Mode robots on the same machine to share a local path for storing packages.

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

注:
設定する一時フォルダーは、NUGET_SCRATCH 変数でのみ使用してください。
NUGET_SCRATCH=C:\NuGetTempFolderNUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE

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

UIPATH_PRESERVE_CREDENTIALS_CASE = TrueUIPATH_PRESERVE_CREDENTIALS_CASE = True
  • uipath.config
  • ファイルにアクセスする
  • カスタマイズ可能な設定
  • UiPath Robot のシステム変数

このページは役に立ちましたか?

サポートを受ける
RPA について学ぶ - オートメーション コース
UiPath コミュニティ フォーラム
Uipath Logo White
信頼とセキュリティ
© 2005-2024 UiPath. All rights reserved.