- 基本情報
- ベスト プラクティス
- テナント
- レジストリ
- Cloud ロボット
- Automation Suite ロボット
- フォルダー コンテキスト
- プロセス
- ジョブ
- Apps (アプリ)
- トリガー
- ログ
- 監視
- インデックス
- キュー
- アセット
- コネクション
- ビジネス ルール
- ストレージ バケット
- MCP サーバー
- Orchestrator のテスト
- リソース カタログ サービス
- Integrations
- トラブルシューティング

Orchestrator ユーザー ガイド
マシンを管理する
マシン オブジェクトは通常、管理者が無人インフラストラクチャの設定を行うために使用します。
マシン テンプレートを追加する
マシン テンプレートを作成するには、以下の手順を実行します。
- [テナント] > [マシン] に移動します。[マシン] ページに、そのテナントのすべてのマシン オブジェクトの一覧が表示されます。
- [マシン] ページで [マシンを追加] > [マシン テンプレート] をクリックします。[マシン テンプレート] ページが表示されます。
- テンプレートを簡単に識別できるよう、[テンプレート名] フィールドにそのテンプレートの名前を入力します。
- [説明] フィールドに、マシンの説明を入力します。
- [ ランタイムの詳細 ] セクションで、各種類の目的のランタイムをマシンに割り当てます。ランタイムの数は、このテンプレートを使用して Orchestrator に接続されている 各ホスト マシン で同時に実行できるジョブの数を表します。
注:
The App Testing runtime type works only with Test Cloud. You can use App Testing to run tests and non-production processes. The Performance Testing runtime type works only with Test Cloud. You can use Performance Testing to run performance scenario executions.
- [プロセスの種類] フィールドおよび [プロセスの対応 OS] フィールドで、ホスト マシンで実行できるプロセスの種類を指定します。
| フィールド | 説明 |
| プロセスの種類 | このマシン テンプレートを使用するインフラストラクチャ上で実行できる実行できるプロセスの種類を以下から選択します。
|
| プロセスの対応 OS | このマシン テンプレートを使用するインフラストラクチャ上で実行できる実行できるプロセスの種類を以下から選択します。
|
Orchestrator は、基になるプロセスがテンプレートの設定と一致しない場合、特定のホスト マシンでジョブを開始できないようにします。無効な設定でジョブを開始しようとすると、設定の修正方法を詳しく示したエラー メッセージが表示されます。
- [クライアント バイナリ (Robot、Assistant、Studio) の自動更新ポリシー] フィールドで、Robot、Assistant、Studio を更新するときに従う更新ポリシーを選択します。
- 最新のパッチ - 更新サーバーで利用可能な最新バージョンをインストールします。
- 最新バージョン - サポートされているバージョンごとに利用可能な最新パッチをインストールします (最新の 2021.10 パッチなど)。
- 特定のバージョン - 更新サーバーで利用可能なパッチのリストから、特定のパッチをインストールします。
- マッピング方法を選択します。アカウントとマシンのマッピングについて詳しくは、こちらをご覧ください。
- すべてのアカウントにこのマシンの使用を許可 - 特定のマッピングはありません。
- 特定のアカウントのみをこのマシンに割り当て - 実行が許可される、特定のアカウントとマシンのペアを設定します。
- [ プロビジョニング] をクリックします。マシンが作成され、ロボットを Orchestrator に接続するために必要な クライアント ID と クライアント シークレット とともに、確認ウィンドウが表示されます。
重要:
- クライアント シークレットは作成直後に 1 回しか表示されません。同じシークレットを複数回使用する場合は、コピーして安全な場所に保存しておいてください。ストレージをセキュリティで保護するために、暗号化やハッシュの使用を検討してください。
- マシン テンプレートを作成した後に、新しいクライアント シークレットを追加できます。詳しくは、「新しいクライアント シークレットを生成する」をご覧ください。
- 完了したら [閉じる] をクリックします。[マシン テンプレート] ウィンドウが閉じて、[マシン] ページに、(先ほど作成したマシン オブジェクトを含む) テナント内のすべてのマシン オブジェクトの一覧が表示されます。
マシンを削除する
マシンを削除するには、次の手順を実行します。
- マシンの [その他のアクション] を選択し、[削除] を選択します。または、グリッドから 1 つまたは複数のマシンを選択して、[削除] を選択します。
- マシンの削除ダイアログが表示されたら、[削除の確定] フィールドに確認のテキスト文字列を入力し、[はい] を選択します。
注:
- 現在実行中のジョブ、停止中のジョブ、または終了中のジョブがあるマシンは削除できません。
- 保留中のジョブまたはトリガーがアタッチされているマシンを削除しようとすると、保留中のジョブの数と、影響を受ける各マシンにアタッチされているトリガーの数と種類が確認ダイアログに表示されます。
- タイム トリガーまたはキュー トリガーがアタッチされているマシンの場合は、以下のシナリオが監査ログに記録され、通知が表示されます。
- マシンを削除すると、有効化されているトリガーはどのマシンにも割り当てられていない状態になります。この場合、トリガーは無効化され、「トリガーが自動的に無効化されました」という通知が表示されます。
- マシンを削除すると、有効化されているトリガーは、そのトリガーが割り当てられている一部 (すべてではない) のマシンから割り当て解除されるか、無効化されているトリガーがどのマシンにも割り当てられていない状態になります。この場合、「トリガーの設定が変更されました」という通知が送信されます。
- 削除されたマシンに関連付けられていた保留中のジョブ、再開されたジョブ、または中断されたジョブは、最終ステート [エラー] に送られます。
マシンのログを表示する
特定のマシンのログを表示するには、該当の [その他のアクション] ボタンをクリックし、[インストール済みのバージョンとログを表示] をクリックします。
マシンのロボットのバージョンを表示する
[マシン] ページでは、[インストールされたバージョン] 列でロボットのバージョンを確認することもできます。標準ロボットのバージョンは、 UiRobotSvc サービスが起動または再起動されるときに取得されます。フローティング ロボットのバージョンは、UiPath® Robot が Orchestrator に接続されるときに取得されます。
特定のマシンに接続されている各 Robot のバージョンをすべて確認するには、[その他のアクション] ボタンをクリックし、次に [インストール済みのバージョンとログを表示] をクリックします。
[マシン] ページの [インストールされたバージョン] 列は、シナリオに応じて、作成されたロボットのバージョンに関する累積した情報を表示します。
- ロボット接続なし
- マシンにまだロボットがプロビジョニングされていません
- 不明
- 1 台以上のロボットが作成されていますが、いずれも接続されていません
- ロボットと Orchestrator 間の接続が確立した後に、1 台以上のロボットが作成されました
- インストールされたバージョン
- 18.2.0 よりも新しいバージョンの Robot 1 台が登録され、接続されています。
- 18.2.0 以降のバージョンのロボットを多く含む(同じもの)がプロビジョニングされ、すべて接続されています。たとえば、18.2.4Robot が接続されている場合は、 18.2.4 が表示されます。18.3.0ロボット (たとえば 11 台) がすべて接続されている場合、 18.3.0 と表示されます。
- < 18.2.0
- 18.2.0 より前のバージョンの Robot 1 台が登録され、接続されています。
- 18.2.0 より前のバージョンのロボットがさらにプロビジョニングされ、すべて接続されています。たとえば、18.1 の Robot を 1 台プロビジョニングして接続している場合は、 <18.2.0 と表示されます。同様に、17.1.0および 18.2.0ロボット (たとえば 9 と 5) がすべて接続されている場合は、 <18.2.0 と表示されます。
- [異なるバージョン番号]
- 異なるバージョンの Robot 2 台以上が登録され、すべて接続されています。 たとえば、合計 14 台の Robot (18.3.0 の Robot 10 台、18.2.4 の Robot 2 台、18.2.0 より前の Robot 2 台) をプロビジョニングしたとします。この場合、3 つのバージョンが表示されます。
この列の値にカーソルを合わせると、ヒントとして詳細が表示されます。
図 1. [インストールされたバージョン] のツールチップ
![[インストールされたバージョン] のツールチップのスクリーンショット](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-the-installed-version-tooltip-226379-b97631c6-9af56620.webp)
下の表は、さまざまなシナリオに応じて [インストールされたバージョン] 列に表示される値と、各値のヒントとして表示される詳細情報をまとめたものです。
| シナリオ | [インストールされたバージョン] 列 | ヒントとして表示される詳細情報の例 |
|---|---|---|
| マシン上でロボットが作成されていません | ロボット接続なし | ロボット接続なし |
| 4 台のロボットを作成しましたが、いずれも接続されていません | 不明 | 不明: 4 台のロボット |
| 18.3.0 のロボットを複数 (11 台) プロビジョニングし、すべて接続しています | 18.3.0 | 18.3.0: 11 robot(s) (ロボット) |
| 17.1.0 と 18.2.0 のロボットを複数 (それぞれ 9 台と 5 台) プロビジョニングし、すべて接続しています | <18.2.0 | <18.2.0: 14 robot(s) (ロボット) |
| 合計 14 台のロボット (18.3.0 のロボット 10 台、18.2.4 のロボット 2 台、18.2.0 より前のロボット 2 台) をプロビジョニングしました | 3 versions (バージョン) | 18.3.0: 10 台のロボット 18.2.4: 2 台のロボット <18.2.0: 2 台のロボット 合計: 14 台のロボット |
マシンに接続されているロボットを表示する
特定のマシンに接続されているロボットを確認するには、[その他のアクション] ボタンをクリックし、[ロボットを表示] をクリックします。[ロボット] ページに自動的にリダイレクトされます。このページでは、該当のマシンに接続されているすべてのロボットが表示されます。
マシンを有効化/無効化する
Only available for Unattended, NonProduction, Testing, App Testing, App Test Robot, and Performance Testing-purposed machines. Disable a machine from the corresponding license pages in order to prevent instant license consumption.
- [ライセンス] ページで、確認したいライセンスの種類の [詳細を確認] をクリックすると、対応するページが表示されます。
- [アクティブ] 列でトグルをオフにします。マシンを無効化するかどうかを確認するダイアログが表示されます。
- [はい] をクリックします。マシンが無効化されます。
- マシンを有効化するには、トグルをオンにします。
マシン上でロボットが実行中である限り、それらのロボットがあるフォルダーにかかわらず、そのマシンを無効化することはできません。
フォルダーにマシンを割り当てる
マシンをフォルダーに割り当てると、さまざまな影響があります。詳しくは、「フォルダーにマシン オブジェクトを割り当てる」をご覧ください。
マシン オブジェクトにタグを追加する
マシン オブジェクトに既存のタグを追加するには、マシンに対する [編集] 権限とタグに対する [表示] 権限が必要です。 マシン オブジェクトに新しいタグを追加するには、マシンに対する [編集] 権限とタグに対する [作成] 権限が必要です。
- 各マシン オブジェクトには、最大 100 万個のキー/値のペアを設定できます。
- ラベルおよびキー/値のプロパティに使用できる文字数は、最大 256 文字です。
- タグ名に使用できない文字は、
<、>、%、&、\、?、/、:です。
マシンへのタグの適用は、マシンの作成時または既存のマシンの編集時に行うことができます。マシンの編集時にマシンにタグを追加するには、以下の手順に従います。
- [マシン] ページで、目的のマシン オブジェクトの横にある [その他のアクション] > [編集] をクリックします。マシン オブジェクトが編集のために開かれます。
- [ラベル] フィールドで、ラベル名の入力を開始します。既存のラベルを選択するか、新しいラベルを作成することができます。
- [プロパティ (キーと値のペア)] フィールドで、[新規追加] をクリックします。
- 新しいキーと値を追加します。既存のキーまたは値を選択するか、新しいキーまたは値を作成することができます。
- 完了したら、[更新] をクリックします。マシン オブジェクトが更新され、新たに作成したタグを (ある場合) 他のオブジェクトで使用できるようになります。
マシン オブジェクトからタグを削除する
オブジェクトからタグを削除するには、以下の手順に従います。
- [マシン] ページで、目的のマシン オブジェクトの横にある [その他のアクション] > [編集] をクリックします。マシン オブジェクトが編集のために開かれます。
- [ラベル] フィールドで、削除するラベル名の横の X をクリックします。ラベルが削除されます。
- [プロパティ (キーと値のペア)] フィールドで、削除するキーまたは値の横の X をクリックします。キーまたは値が削除されます。
- キー/値のペアを削除するには、そのエントリに対応する削除アイコンをクリックします。キー/値のペアが削除されます。
- 完了したら、[更新] をクリックします。マシンが更新され、タグが削除されます。
マシン テンプレートを使用して無人インフラストラクチャを最適化する
マシンを特定のプロセスの実行に特化することで、無人オートメーションのワークロードを既存のインフラストラクチャに分散し、効率を最大限に高めてインフラストラクチャのコストを削減します。
詳しくは、「 マシン テンプレートを使用して無人インフラストラクチャを最適化する 」をご覧ください。
マシンのメンテナンスを有効化する
マシンのメンテナンスを実行するときには、いつでもそのマシンをオフラインにできます。この機能は、テナント レベルの [ 監視 ] ページの [ 無人セッション ] セクションで [ メンテナンス ] 列のトグルを [オン] に切り替えることで有効化されます。
図 2. マシンのメンテナンスの有効化
![[無人セッション] インターフェイスのスクリーンショット](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-the-unattended-sessions-interface-642841-db9cdc15-26ade32a.webp)
このトグルを有効化すると、以下を実行するかどうかを確認するウィンドウが表示されます。
- ジョブの実行が完了するまで待機してからメンテナンスを開始 (これは既定のオプションです)。
- メンテナンス モードのマシンは、新しいジョブを受け入れられません。メンテナンス モードを有効化してこのオプションを選択すると、実行中のジョブはすべて完了しますが、その間に新しいジョブは検出されません。
- このオプションは、すべてのジョブが完了するのを待機し、停止コマンドは発行しません。
- Stop all running jobs and wait for them to finish.
注:
Jobs can only shut down gracefully if the underlying automation is designed to handle stop requests by implementing proper graceful stop logic. The behavior also depends on how the automation was built.
- 実行中のすべてのジョブを今すぐ強制終了
[確認] をクリックするとメンテナンス モードが有効化され、[キャンセル] ではメンテナンス モードに入るためのリクエストが取り消されます。
備考
- 保留中のジョブは、利用可能な別のマシン、またはオンラインに戻った同じマシンに取り込まれるのを待機している間、ジョブのステータスを維持します。
- メンテナンス モードはセッション (マシン + ホスト名) ごとに設定されるため、仮想/物理マシンでメンテナンスを実行できます。セッションに複数のランタイムが関連付けられている場合、それらのランタイムはすべて既定で選択されます。