リモートアクションを実行する

ユースケースに応じて、リモートアクション管理者はさまざまなリモートアクションのトリガーを設定する必要があります：

• 手動​​​​*??*Wait keep markdown? It's text:Manual should be 手動. Keep markdown.
• スケジュール
• API
• Workflows
• Spark

これらの設定により、従業員のデバイスでリモートアクションを実行する方法が決まります。

リモートアクションの実行方法

以下のセクションでは、リモートアクションを実行するすべての方法について説明します。

リモートアクションを手動で実行する

対象のデバイスまたは VDI セッションに対して、Nexthink Web インターフェースからオンデマンドでリモートアクションを実行します。 ユースケースに応じて、リモートアクションは単一の対象に対して、または複数の対象に同時に実行できます。 以下のセクションでは、リモートアクションを手動でトリガーするために使用できる Nexthink の機能とインターフェイスについて説明します。

Investigations モジュールからリモートアクションを実行する

Investigations から：

1. NQL エディターまたはビジュアルエディターを使用して、デバイスまたは VDI セッションのリストをクエリします
2. 調査結果テーブルから 1 台または複数のデバイスまたは VDI セッションを選択し、アクションバーの アクションを実行 をクリックします。 アクションの選択 ポップアップには、利用可能なアクションの一覧が表示されます。

   • セッションで実行できるのは、VDI 用に構成されたリモートアクション のみです。
3. ロケットアイコンで識別できる目的のリモートアクションを選択し、選択したデバイスまたはセッションで実行します。

   • リモートアクションにパラメーターがある場合、確定する前に各パラメーターに値を入力する必要があります。
   • 実行先... を選択します。
   • 検証メッセージにより、システムがリモートアクションをトリガーしたことが確認されます。
   • 結果を表示 をクリックして、リモートアクションの詳細ダッシュボードにアクセスします。

集計結果を伴う NQL クエリを使用して調査テーブルからリモートアクションを正しく実行するには、device.collector.uid で summarize するようにしてください。デバイス name で集計された結果からは、アクションを手動でトリガーできません。

以下に、手動でのリモートアクション実行に適した、出力を集計した NQL クエリの実例を示します：

devices during past 7D
| where (device.operating_system.platform == windows)
| where (remote_action.get_configuration_manager_sccm_client_status.execution.status == success and remote_action.get_configuration_manager_sccm_client_status.execution.outputs.ClientInstalled == false)
| summarize devices_without_SCCM_client_ = count() by device.collector.uid
| list device.collector.uid

多数のデバイスでリモートアクションを実行する場合、ユーザーインターフェースに表示されるレコード数は 10,000 件に制限されるため、実行結果をエクスポートすることを Nexthink は推奨します。

デバイスビューまたはセッションビューからリモートアクションを実行する

デバイスビューまたはセッションビューから：

1. ページ右側の Actions パネルを切り替えて、ユーザーロールで利用可能なすべてのリモートアクションとワークフローのリストを表示します。
2. リモートアクションを選択します：

   • リモートアクションにカーソルを合わせてアクションメニューを表示し、Execute action を選択して、選択したデバイスまたはセッションでリモートアクションを実行します。
   • Yes を選択して、リモートアクションの実行を確認します。
   • 検証メッセージにより、システムがリモートアクションをトリガーしたことが確認されます。
   • View results をクリックして、リモートアクションの詳細ダッシュボードにアクセスします。

Amplify からリモートアクションを実行する

チケットを起票した従業員のデバイスを対象に、Amplify ウィンドウから直接リモートアクションを実行します。

• 該当するデバイスの Amplify で Actions タブを開きます。

  • Checklist タブに一覧表示される関連アクションも確認して選択できます。
• リモートアクションの詳細を展開すると、実行詳細をコピーするオプションを含め、リモートアクションの直近 2 件の実行ステータスを表示できます。
• Run を選択して、デバイス上でリモートアクションを実行します。
• Yes を選択して、リモートアクションの実行を確認します。
• 検証メッセージにより、システムがリモートアクションをトリガーしたことが確認されます。

リモートアクション管理ページからリモートアクションを実行する

リモートアクション管理ページからリモートアクションをトリガーしてテストします。 リモートアクションを管理する ドキュメントを参照してください。

リモートアクションのスケジュール設定

スケジュールされたリモートアクションは、手動でトリガーする必要がありません。 スケジュールを設定すると、リモートアクションは定義したスケジュールに従って自動的に実行されます。

システムは、選択したスケジュールに基づいて定義済みの NQL クエリを評価し、結果として得られたデバイスまたはセッションにリモートアクションを送信します。

詳細については、リモートアクションをスケジュールする ドキュメンテーションを参照してください。

API を使用したリモートアクションの実行

Nexthink Remote Actions API を使用して、外部アプリケーションからリモートアクションをトリガーします。

詳細については、Remote Action API のドキュメントを参照してください。

ワークフロー内でのリモートアクションの実行

ワークフローでは、対象デバイスに関する追加の診断情報を収集したり、問題を修復したりするために、リモートアクションをトリガーできます。 返された出力値は、後続のワークフローステップまたは条件で使用できます。

詳細については、リモートアクションシンクレット を参照してください。

Spark によるリモートアクションの実行

Spark は、従業員とのやり取りから直接、診断と修復を自動化するためにリモートアクションを実行できます。 Spark で有効にすると、リモートアクションは、問題の解決、追加のデバイス情報の収集、またはセルフサービスエクスペリエンスのサポートに役立つ、Spark が実行可能な自動アクションとして利用できるようになります。

詳細については、Spark アクションの管理 を参照してください。

リモートアクションのパラメーターの指定

リモートアクションはパラメーター化できます。 このような場合、リモートアクションを手動でトリガーするユーザー、または API 呼び出しを介して実行するシステムは、必要な入力値を指定する必要があります。

詳細については、リモートアクションの作成と設定 を参照してください。

Amplify からのリモートアクション実行の追跡

Amplify からトリガーされたすべてのリモートアクションを追跡し、remote_action.executions テーブルのフィールドをフィルタリングします。 トリガーされたリモートアクションのデータにアクセスするには、NQL クエリにこれらのフィールドを含めます。

• trigger_method: リモートアクションの実行を開始するために使用されるトリガーモードです。
• internal_source: リモートアクションをトリガーするために使用された Nexthink モジュールです。
• external_reference: チケットを追跡するために使用される参照 ID です。
• external_source: リモートアクションが実行された外部 Web アプリケーションレコードの識別子です。

このテーブルは、remote_action.executions で実行された NQL クエリの結果に基づいて整理されます。

例 1

internal_source に基づいて、トリガーされたすべてのリモートアクションを返す NQL クエリ

remote_action.executions during past 7d
| where internal_source == "Amplify"
| list remote_action.name , device.name , time , trigger_method , status

例 2

trigger_method に基づいて、トリガーされたすべてのリモートアクションを返す NQL クエリ。

remote_action.executions during past 7d
| where trigger_method == manual
| list remote_action.name , device.name , time , trigger_method , status

NQL のターゲティングクエリからリモートアクションを実行する場合、デバイスは name でターゲットにできないため、必ず device UID で集計してください。