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

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

リモートアクション管理ページにアクセスするには、以下の手順に従ってください:

  1. リモートアクション > リモートアクションの管理 を選択します。

ManageRemoteActions.png

組み込みリモートアクション

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

Nexthinkは、Nexthinkライブラリから手動でインストールできる、事前設定されたリモートアクションのセットを提供します。 あらかじめ定義されたリモートアクションをインストール、管理、更新するには、Nexthinkインスタンス内のNexthinkライブラリモジュールに移動します。

詳細はNexthinkライブラリのドキュメントをご参照ください。

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

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

詳細はNexthinkライブラリのドキュメントをご参照ください。

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

独自のリモートアクションを一から作成することで、特定のキャンペーン結果に従ってアプリケーションを開くものから、従業員のデバイスを更新したり、リモートトラブルシューティングを実行したりするものまで、多様なリモートアクションを定義できます。

詳細はカスタムリモートアクションの作成をご参照ください。 独自のリモートアクションスクリプトを記述する場合、Windows用リモートアクションのスクリプト作成およびMac用リモートアクションのスクリプト作成のドキュメントをご参照ください。

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

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

  1. メインメニューからリモートアクションを選択します。

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

RemoteActions - 1707382332.png

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

  1. リモートアクション > リモートアクションの管理を選択します。

  2. ページの右上にある新しいリモートアクションボタンをクリックします。

  3. 必要な情報をすべて入力し、リモートアクションを保存ボタンをクリックします。

新しいリモートアクションページには、リモートアクションを定義するための2つの設定タブがあります。

一般タブ

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

トリガー

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

  • 手動: ウェブインターフェースから手動でリモートアクションをトリガーします。

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

  • ワークフロー: Remote action Thinklet ワークフローを使用してリモートアクションのリスト化と実行を有効にします。

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

ターゲット

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

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

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

    • セッションをターゲットにする場合、以下を選択します:

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

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

    • オプションとして、上記の選択をユーザーが上書きできるようにします。

目的

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

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

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

スクリプト

WindowsとmacOSプラットフォーム用のリモートアクションスクリプトをインポートします。 インポートした後、パラメータフィールドに入力し、出力情報が表示されます。

スクリプトを実行するコンテキストを選択する高度な設定オプションを使用し、利用可能なオプションにはローカルシステム、インタラクティブユーザー、またはサービスが含まれます。

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

ライブラリパックの更新は既存のスクリプトとリモートアクションのすべての設定を上書きするため、更新後に再署名が必要です。 そのため、ライブラリからインストールされたリモートアクションとシステムリモートアクションについては、スクリプトの再署名以外の変更を行うことをNexthinkはお勧めしません。

Windows上でリモートアクション用のスクリプトを書くためのドキュメンテーションは、Writing scripts for remote actions on WindowsMac上のリモートアクション用スクリプトを書いてくださいをご参照ください。

リモートアクションのスクリプトは600 KBの最大サイズ制限があります:

合計で30 KBキャラクターの最大50の入力、更に50の出力がある可能性があります。

値の制限は種類によって異なります。

RA - 1710253477.png

パラメータ

スクリプトの実行に必要な最大50の入力を指定できます。 リストの値を指定し、実行中にカスタム値を入力できるようにユーザーに許可するオプションがあります。

  • 名前: システムがパラメータ値を尋ねる時にユーザーに表示する名前。

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

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

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

出力

リモートアクションの最大50の出力を定義します。

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

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

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

高度な設定

スクリプトをローカルシステムユーザー (デフォルト)、インタラクティブユーザー、またはサービスとして実行することを選択できます。

  • ローカルシステムユーザー: システムの権限を必要とするタスク (例: ソフトウェアのアンインストール、ドライバーやレジストリキーのシステム情報の取得) に使用します。

  • インタラクティブユーザー: 特定のユーザーのために実行されるアクションに使用します。(例: リサイクルビンのサイズを取得、キャンペーンを使用してアプリケーションを閉じる) これらをローカルシステムユーザーとして実行する場合、システムユーザーのリサイクルビンのサイズを返したり、システムによって使用されるアプリケーションを閉じようとすることになります。

  • サービス: リモートアクションが専用のサービス内で実行されるように構成します。 例として、Windowsサーバー (プロキシ) 上で、Active Directoryを更新する権限があるサービスアカウントを使用して、リモートアクションが実行できます。 サービスとしての実行はWindowsデバイスでのみサポートされ、Windowsスクリプト (PowerShell) の使用を必要とします。 この機能を使用するには、サービスの作成に関する具体的な手順に従います。 サービス名フィールドでは、サービスセットアップ中に使用した--service-nameパラメータの値を指定する必要があります。

スクリプトのタイムアウトを秒単位で設定します。 割り当てられた時間内にリモートアクションが完了しない場合、システムはスクリプトを終了します。

詳しくは、製品内文書をご参照ください。 サイドパネルメニューで見つけることができます。

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

リモートアクションテーブルには、利用可能なすべてのリモートアクションがリストされています。

RemoteActions - 1707385103.png

テーブルは以下の方法で整理されています:

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

  • 由来: リモートアクションがどこから発信されているかの表示:

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

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

      • 説明

      • トリガー

      • 入力パラメータの説明

      • 入力パラメータの値

      • 出力パラメータの説明

      • カスタム値

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

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

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

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

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

    • 手動: 調査またはデバイスビューなどのウェブインターフェースから手動でリモートアクションをトリガーします。

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

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

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

アクションメニュー

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

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

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

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

  • タグの管理: リモートアクションタグを作成、割り当て、編集します。

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

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

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

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

リモートアクションのタグ付け

タグ付けはリモートアクションを効率的に整理し、データへの迅速で簡単なナビゲーションを促進します。

タグ右側パネルを開いて:

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

  • リモートアクションテーブルをフィルタリングするために1つまたは複数のタグを選択します。

モニターに1つまたは複数のタグを追加するには、リモートアクション > リモートアクションの管理ページから:

  1. リモートアクション上にカーソルを置くと、アクションメニューが表示され、タグの管理を選択します。

  2. タグの管理ポップアップから次のことができます:

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

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

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

  1. 別の方法として、複数のリモートアクションを選択して一括でタグの管理を行うことができます。

リモートアクションには最大10のタグを関連付けることができます。

EditTagsRA.png

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

プロファイルを共有し、ダッシュボードを表示したり、編集やリモートアクションの実行を行うための適切な権限を付与します。 例えば、Get Battery Status リモートアクションを定めた サービスデスク プロファイルに、リモートアクションダッシュボードの表示および実行権限を付与して共有できます。 すべてのリモートアクションを管理する機能許可が有効にされているユーザーのみ、共有オプションを見ることができます。 詳しくは、リモートアクションの使用を始めるドキュメントをご参照ください。

share remote action modal
  • リモートアクション上にカーソルを置いてアクションメニューを表示し、共有を選択します。 共有リモートアクションのモーダルが開きます。

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

  • 権限を選択 ドロップダウンメニューから、プロファイルに対して適切な権限を選びます。 選択肢は次のとおりです。

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

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

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

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

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

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

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

  1. リモートアクション > リモートアクション管理 ページの右上コーナーにある インポート ボタンをクリックします。

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

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

Nexthink ライブラリからリモートアクションをインポートするには:

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

  • Nexthinkライブラリ を選択します。 システムはダウンロード用のリモートアクションがあるライブラリページに移動します。

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

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

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

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

メインメニューから調査を選択:

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

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

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

調査テーブルからNQLクエリを使用して結果を要約した場合に、適切にリモートアクションを実行するには、summarizeを使ってdevice.collector.uidでまとめることを確認してください。アクションはデバイス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は実行結果をエクスポートすることを勧めています。

デバイスビューからのリモートアクションの実行

調査またはNexthinkアシストの検索結果からデバイスを選択した後:

  1. ページの右側からアクションパネルを切り替えます。

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

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

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

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

  • internal_source: リモートアクションのトリガーに使用されたNexthinkモジュール。

  • external_reference: チケットの追跡に使用された参照ID。

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

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

Tracking remote action execution

例1

internal_sourceに基づくすべてのトリガーされたリモートアクションを返すNQLクエリ
過去7日間のremote_action.executions
| internal_source == "Amplify" の場合
| remote_action.name , device.name , time , trigger_method , status をリスト

例2

trigger_methodに基づくすべてのトリガーされたリモートアクションを返すNQLクエリ。
過去7日間のremote_action.executions
| trigger_method == manual の場合
| remote_action.name , device.name , time , trigger_method , status をリスト

NQLを使用したリモートアクションのクエリ

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


関連トピック

Last updated

Was this helpful?