オートメーションの動作は、マシンによって異なることがあります。オートメーションが実行される運用環境のマシンの設定が、オートメーションが設計されたマシンと異なる場合 (たとえば、マシンのハードウェア、ソフトウェア、権限が異なる場合、またはマシンが分離されたネットワークにある場合)、そのマシン上のロボットでプロセスをテストし、デバッグする必要があります。

Remote debugging enables you to run and debug attended and unattended processes on robots deployed to remote machines, including on Linux robots that can run cross-platform projects.

次のいずれかの接続の種類で、リモートロボットに接続できます。

Remote Machine - Establish a TCP/IP connection to the robot on the remote machine.
Unattended Robot - Connect to an unattended robot in the same tenant using Orchestrator.

Using remote debugging requires that the project is open in Studio. If you are using source control, to make sure you are working with the latest project version, we recommend enabling the Enforce Check-In before Publish design setting.

リモートマシン接続

リモートマシン接続を使用してプロジェクトをリモートで実行またはデバッグするには、以下の手順を実行します。

以下の点をご確認ください。
- Studio のマシンとリモートマシン間に TCP/IP 接続が確立されている。
- リモート環境の Robot のバージョンが Studio と同じである。
リモートマシンで、リモートデバッグ要求を受け入れるロボットを設定します。
対話型認証が強制されている Orchestrator で、無人プロセスを実行またはデバッグする場合は、リモートロボットが以下のいずれかの条件を満たしていることを確認します。
- 対話型サインインを使用して Orchestrator に接続されている。
- マシンキーを使用して接続されており、ユーザーが Assistant からサインインしている。
- マシンキーを使用して接続されており、Assistant からサインインしているユーザーがいない。また、マシンに対するトラブルシューティングセッションが Orchestrator で有効化されている。詳しくは、「無人プロセスをデバッグする」をご覧ください。
Studio で、以下の手順を実行します。
1. リモートロボットへの接続を設定します。
2. リモート実行が有効化されていることを確認します。
3. プロジェクトを実行またはデバッグします。

リモートマシンでロボットを設定する

リモートロボットをデバッグで使用するには、事前に Studio からのリモートデバッグ要求を受け入れるようにマシン上の UiPath.RemoteDebugging.Agent ユーティリティを設定する必要があります。

インストールディレクトリに移動します。
- Windows 環境のロボットの場合 - UiPath のインストールフォルダー (既定では、マシン単位のインストールの場合は %PROGRAMFILES%\UiPath\Studio、ユーザー単位のインストールの場合は %localappdata%\Programs\UiPath\Studio) でコマンドプロンプトを開きます。
- Linux 環境のロボットの場合 - コマンドラインターミナルから /root/application に移動します。
次のコマンドを実行します。
- Windows 環境のロボットの場合 - UiPath.RemoteDebugging.Agent.exe enable --port <port_number> --password <pasword> --verbose
- Linux 環境のロボットの場合 - ~/application # dotnet ./UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose
コマンドの引数はすべて任意です。
- --port <port_number> - Studio からリモートデバッグコマンドを受け取るために使用するポートを入力します。指定しないと、既定でポート 8573 が使用されます。
  ポートがファイアウォールで開かれていて、他のアプリケーションにまだバインドされていない必要があります。
- --password <password> - リモートデバッグエージェントへの接続を設定するときに Studio で指定する必要のあるパスワードを入力します。
- --verbose - 詳細な情報をコンソールに記録します。
次のメッセージが表示されます。
Agent online and waiting for commands...
コマンドプロンプトから hostname または ipconfig コマンドを実行し、マシンの IP アドレスまたはホスト名をメモします。Studio で接続を設定する際に、いずれかの値と設定されたポートを指定する必要があります。

ロボットがリモートデバッグステートの間は、Orchestrator またはローカルの Assistant から有人ジョブまたは無人ジョブを実行することはできません。Robot のインストールがライセンスされていないマシンにも、リモートデバッグコマンドを送信できます。