リモートアクションの管理

リモートアクション管理ページへのアクセス

リモートアクション管理ページにアクセスするには:

1. Remote Actions > Manage remote actions を選択します。

内蔵リモートアクション

ライブラリからインストールされたリモートアクション

Nexthinkは、Nexthinkライブラリから手動でインストールできる一連の事前構成済みリモートアクションを提供します。 定義済みのリモートアクションをインストール、管理、更新するには、Nexthinkインスタンス内のNexthinkライブラリモジュールに移動します。

詳細については、Nexthink Library ドキュメントを参照してください。

ライブラリからコピーされたリモートアクション

ライブラリからインストールされたリモートアクションとは異なり、自分のニーズに合わせてカスタマイズしやすいようにライブラリからコピーしたリモートアクションを自由に編集できます。 Nexthinkは、カスタムリモートアクションを作成する前の出発点として、ライブラリのコンテンツを使用することを推奨します。

詳細については、Nexthink Library ドキュメントを参照してください。

カスタムリモートアクション

ゼロからRemote Actionsを作成することで、特定のCampaignsの結果に従ってApplicationsを開くことから、社員のデバイスを更新すること、Remote Actionによるトラブルシューティングまで、多様なRemote Actionsを定義できます；

詳細については、カスタムリモートアクションの作成 を参照してください。 独自のリモートアクションスクリプトを記述したい場合は、詳細について Windowsでリモートアクションのためのスクリプトを書く と Macでリモートアクションのためのスクリプトを書く を参照してください。

リモートアクションの作成

新しいリモートアクションを作成するには:

1. メインメニューから Remote Actions を選択します。

2. ナビゲーションメニューの上部にある 新規 ボタンをクリックします。

また、管理ページを通じて新しいリモートアクションを作成します:

1. Remote Actions > Manage remote actions を選択します。

2. ページの右上隅にある New remote action ボタンをクリックします。

3. すべての必要な情報を入力して、 Save Remote Action ボタンをクリックします。

The New remote action page includes 2 configuration tabs to define the remote action.

一般タブ

名前、NQL ID、説明、トリガーオプション、ターゲットオプション、リモートアクションの目的を入力します。

トリガー

リモートアクションのトリガーメカニズムを選択します:

• マニュアル: Webインターフェースからリモートアクションを手動でトリガーします。

• API: 選択したデバイスでAPIを使用して実行をトリガーします。

• ワークフロー: Thinkletワークフローを使用してリモートアクションのリスト表示と実行を可能にします。

• スケジュール: スケジュール済みの時間にNQLクエリを使用して実行をトリガーします。

ターゲット

リモートアクションがターゲットとする環境を選択します：

• デバイス：特定のデバイスをターゲットにするリモートアクションを有効にします。

• VDIセッション：VDIセッションをターゲットにするリモートアクションを有効にします。

  • セッションをターゲットにする際、対象を選択してください：

    • VDI: リモートアクションはそのセッションのVDIデバイスを対象とします。

    • クライアント: リモートアクションは、ユーザーがVDIセッションに接続するクライアントデバイスを対象とします。 これは、クライアントデバイスにCollectorがインストールされている場合にのみ機能します。

  • 必要に応じて、上記の選択をユーザーが上書きできるようにします。

目的

リモートアクションの目的を選択します:

• データ収集: リモートアクションの目的は、ターゲットデバイスからデータを収集することです。

• 修正: リモートアクションの目的は、ターゲットデバイスでアクションを実行することです。

スクリプト

WindowsおよびmacOSプラットフォーム用のリモートアクションスクリプトをインポートします。 インポートしたら、パラメータ欄に記入し、出力情報が表示されます；

高度な設定オプションを使用してスクリプトを実行するためのコンテキストを選択し、利用可能なオプションにはローカルシステム、対話的ユーザー、またはサービスがあります；

リモートアクションを保存するには、Windows PowerShell または macOS Bash スクリプトを追加する必要があります。

ライブラリーパックの更新により既存のスクリプトおよびリモートアクションのすべての設定が上書きされ、更新後に再署名が必要になります。 したがって、ライブラリからインストールされたリモートアクションおよびシステムリモートアクションに対して、スクリプトの再署名以外の変更は行わないことをNexthinkは推奨します。

詳細については、Windowsでリモートアクションのためのスクリプトを書く と Macでリモートアクションのためのスクリプトを書く ドキュメントを参照してください。

パラメーター

You can specify up to 50 inputs required for the script's execution. 許可されたパラメーター値のリストを定義し、ユーザーが実行中にカスタム値を提供できるようにするオプションがあります。

• 名前: システムがパラメーター値を求める際にユーザーに表示される名前。

• 説明: パラメーターの意味のある説明。

• 値: パラメーターの可能な値のリスト、1行につき1つの値。 少なくとも1つの値が必要です。 最初の行にある値がデフォルト値オプションです。

• ユーザーによるカスタム値の入力を許可する: リストに含まれていないカスタムパラメーター値をユーザーが指定できるようにします。

出力

Define up to 50 outputs of the remote action.

• 名前: 調査やダッシュボードでリモートアクションの出力を表示する際に表示される名前。

• 説明: 出力パラメーターの意味のある説明。

• 型: パラメーターのデータタイプ。

高度な設定

Choose to run the script as a local system user (default), as an interactive user or as a service:

• ローカルシステムユーザー: システム情報の値を取得したり、ソフトウェアをアンインストールしたりするようなシステム権限が必要なタスクに使用します。

• インタラクティブユーザー: リサイクルビンのサイズを取得したり、キャンペーンを使用してアプリケーションを終了したりするなど、特定のユーザー向けに実行されるアクションに使用します。 これらをローカルシステムユーザーとして実行すると、システムユーザーのリサイクルビンのサイズが返されたり、システムが使用するアプリケーションを終了しようとしたりします。

• サービス: 専用サービス内でリモートアクションを実行するように設定するために使用します。 For example, remote action can run on a Windows server (proxy) using a service account that has the necessary permissions to update Active Directory. Running as a service is only supported on Windows devices and requires the use of a Windows script (PowerShell). この機能を使用するには、サービスを作成するためのターゲットデバイスでの特定の手順に従います。 サービス名フィールドには、サービスセットアップ時に使用される --service-name パラメータの値を指定する必要があります。

Set the time-out for the script (in seconds). 指定された時間内にリモートアクションが完了できない場合、システムはスクリプトを終了します。

詳細については、製品内のドキュメントを参照してください。 これはサイドパネルメニューにあります。

リモートアクションテーブル

リモートアクションテーブルは、利用可能なすべてのリモートアクションを一覧します。

テーブルは以下によって整理されています:

• 名前: リモートアクションの名前。

• 起源: リモートアクションの発生源を示すもの:

  • カスタム: Remote Actionsモジュール内で作成されたリモートアクション。

  • ライブラリからインストールされたもの: Nexthink Libraryモジュールからインストールされたリモートアクション。 次のフィールドを設定できます:

    • 説明

    • トリガー

    • 入力パラメーターの説明

    • 入力パラメーターの値

    • 出力パラメーターの説明

    • カスタム値

    • スケジュールタブ内のすべてのフィールド 詳細については、リモートアクションのインストール方法に関する Nexthink Library ドキュメントを参照してください。

  • ライブラリからコピーされたもの: Nexthink Libraryモジュールからコピーされたリモートアクション。 ニーズに合わせてコピーされたリモートアクションを完全に編集できます。 リモートアクションのコピーの作成方法に関する詳細は、Nexthink Library ドキュメントを参照してください。

• タグ: 各リモートアクションに割り当てられたタグのリストを表示します。

• プラットフォーム: リモートアクションが設計されたプラットフォームです。

• トリガー: 次のオプションでリモートアクションを構成するために使用されるトリガーメソッド:

  • Manual: Trigger the remote action manually from the web interface, e.g., through Investigations or Device View.

  • API: 選択したデバイスでAPIを使用して実行をトリガーします。

  • スケジュール: スケジュールされた時間にNQLクエリを使用して定期的に実行をトリガーします。

• 検索フィールド: リモートアクションの名前を検索することでテーブルをフィルタリングするフィールド。

アクションメニュー

関連するリモートアクションを選択し、テーブルの右側にあるアクションメニューをクリックして表示します:

• 詳細: 実行詳細ページを開きます。

• 設定: ライブラリリモートアクションの構成を変更します。

• 編集: 選択したリモートアクションを編集します。

• タグを管理する：Remote Actionタグを作成、割り当て、編集する；

• 共有: 他のユーザーにリモートアクションを表示または編集する権限を付与します。 リモートアクションの共有 セクションを参照してください。

• NQL IDのコピー: APIで使用するためにリモートアクションのNQL IDをコピーします。

• エクスポート: リモートアクションをJSONファイルにエクスポートします。

• 削除: システムからリモートアクションを削除します。

タグ付け Remote Actionタグ

タグ付けによってRemote Actionsを効率よく整理し、データの迅速で簡単なナビゲーションを促進します；

タグの右側パネルを開いて：

• パネルの上部で特定のタグを検索します。

• 1つ以上のタグを選択して、リモートアクションテーブルをフィルタリングします。

モニターに1つ以上のタグを追加するには、Remote Actions > Remote Actionsを管理ページから：

1. リモートアクションの上にカーソルを置いて、アクションメニューを表示し、タグを管理を選択。

2. タグを管理ポップアップから：

• 新しいタグを入力するか、既存のものを選んでリモートアクションに追加します。

• 特定のタグアイテムのアクションメニューを開いて、タグを削除またはタグの色を変更します；

  • タグを削除すると、それに関連付けられたリモートアクションからのみ削除されます。

1. あるいは、複数のリモートアクションを選択して一括でタグを管理します。

リモートアクションの共有

リモートアクションをプロファイルと共有し、ダッシュボードの表示、編集の実行、およびリモートアクションの実行に適切な権限を付与します。 例えば、 Get Battery Status リモートアクションを Service desk プロファイルと共有し、リモートアクションダッシュボードを表示および実行する権限を含めることができます。 Manage All Remote Actions 機能の権限が有効なユーザーのみが 共有 オプションを表示できます。 詳細については、Remote Actionsを使用した開始ドキュメントを参照してください。

• リモートアクションにカーソルを合わせてアクションメニューを表示し、共有を選択します。 共有リモートアクションモーダルが開きます。

• プロファイルの追加 テキストフィールドに、リモートアクションを共有したいユーザープロファイルを入力します。

• 権限の選択 ドロップダウンメニューから、プロファイルに適切な権限を選択します。 選択肢は以下の通りです:

  • ダッシュボードを表示: ナビゲーションパネルおよび概要ページのリモートアクションテーブルからリモートアクションダッシュボードにアクセスします。

  • 編集: リモートアクションを編集します。

  • 実行: リモートアクションを実行します。

• 全てをクリアをクリックして、すべての権限を無効にします。

• 権限を付与ボタンをクリックしてリモートアクションを共有します。

リモートアクションをインポートする

リモートアクションをJSON形式でローカルデバイスからインポートするには：

1. リモート操作 > リモート操作の管理 ページの右上隅にあるインポートボタンをクリックします。

2. 複数のJSONファイルをハードドライブから選択またはドラッグしてシステムにインポートします。

• ローカルデバイスからインポートされたすべての項目は、カスタムとして表示されます；

Nexthink Library からリモートアクションをインポートするには：

• インポートボタンの隣にあるアクションメニューをクリックします。

• Nexthink Libraryを選択します。 システムはリモートアクションをダウンロードするためのライブラリページにリダイレクトします。

• ダウンロードしたファイルをインポートします。

オンデマンドでリモートアクションを実行する

調査ページでNQLクエリの結果からオンデマンドでリモートアクションを実行します。 リモート アクションの複数回実行を許可するように設定しているかどうかに応じて、単一のターゲット デバイス、複数のデバイス、またはすべてのデバイスで実行できます。

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

メインメニューのInvestigationsから：

1. NQLエディター もしくは ビジュアルエディターを使用して、 デバイス または VDIセッションのリストをクエリします

2. 一つまたは複数のデバイスまたはVDIセッションを選択して、アクションバーを使用してアクションを実行します。

3. 選択したセッション/デバイスで実行するリモートアクションを選び、ロケットアイコンで識別します。

• セッションで実行可能なのはVDI用に設定されたリモートアクションのみです。

調査テーブルからNQLクエリを使用して要約結果とともに遠隔操作を適切に実行するには、アクションを手動でトリガーすることができないため、「device.collector.uid」で「summarize」することを確認してください。

手動の遠隔操作実行に適した、要約された出力の動作する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

Device Viewからリモートアクションを実行

調査またはNexthink Assistの検索結果からデバイスを選択した後：

1. ページの右側から Actions パネルeを切り替えます

2. リモートアクションを選択します。 ハンバーガーメニューから、アクションを実行を選択します。

リモートアクションの実行を追跡

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

• trigger_method: リモートアクション実行を開始するのに使用したトリガーモード。

• internal_source: リモートアクションをトリガーするために使用したNexthinkモジュール。

• external_reference: チケットを追跡するために使用する参照ID。

• external_source: リモートアクションが実行された外部webアプリケーションレコードの識別子。

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

例 1

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

例 2

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

NQLでリモートアクションをクエリする

リモートアクションのNQLの例を参照してください。

関連トピック

• リモートアクションAPI

• アプリケーション制御とリモートアクション

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