リモートアクションの管理
Last updated
Last updated
リモートアクション管理ページにアクセスするには:
Remote Actions > Manage remote actions を選択します。
Nexthinkは、Nexthinkライブラリから手動でインストールできる一連の事前構成済みリモートアクションを提供します。 定義済みのリモートアクションをインストール、管理、更新するには、Nexthinkインスタンス内のNexthinkライブラリモジュールに移動します。
詳細については、Nexthink Library ドキュメントを参照してください。
ライブラリからインストールされたリモートアクションとは異なり、自分のニーズに合わせてカスタマイズしやすいようにライブラリからコピーしたリモートアクションを自由に編集できます。 Nexthinkは、カスタムリモートアクションを作成する前の出発点として、ライブラリのコンテンツを使用することを推奨します。
詳細については、Nexthink Library ドキュメントを参照してください。
最初からリモートアクションを作成すると、特定のキャンペーン結果に従ったアプリケーションの起動からリモートでのトラブルシューティングに至るまで、多様なリモートアクションを定義できます。
詳細については、カスタムリモートアクションの作成 を参照してください。 独自のリモートアクションスクリプトを記述したい場合は、詳細について Windowsでリモートアクションのためのスクリプトを書く と Macでリモートアクションのためのスクリプトを書く を参照してください。
新しいリモートアクションを作成するには:
メインメニューから Remote Actions を選択します。
ナビゲーションメニューの上部にある 新規 ボタンをクリックします。
また、管理ページを通じて新しいリモートアクションを作成します:
Remote Actions > Manage remote actions を選択します。
ページの右上隅にある New remote action ボタンをクリックします。
すべての必要な情報を入力して、 Save Remote Action ボタンをクリックします。
The New remote action page includes 2 configuration tabs to define the remote action.
リモートアクションの名前、NQL ID、説明、トリガーオプション、および目的を入力します。
リモートアクションのトリガーメカニズムを選択します:
マニュアル: Webインターフェースからリモートアクションを手動でトリガーします。
API: 選択したデバイスでAPIを使用して実行をトリガーします。
ワークフロー: Thinkletワークフローを使用してリモートアクションのリスト表示と実行を可能にします。
スケジュール: スケジュール済みの時間にNQLクエリを使用して実行をトリガーします。
リモートアクションの目的を選択します:
データ収集: リモートアクションの目的は、ターゲットデバイスからデータを収集することです。
修正: リモートアクションの目的は、ターゲットデバイスでアクションを実行することです。
WindowsおよびmacOSプラットフォーム用のリモートアクションスクリプトをインポートします。 インポートしたら、パラメーターフィールドに入力し、出力情報が表示されます。
高度な設定オプションを使用してスクリプトの実行コンテキストを選択し、利用可能なオプションにはローカル システム、インタラクティブ ユーザー、またはサービスがあります。
リモートアクションを保存するには、Windows PowerShell または macOS Bash スクリプトを追加する必要があります。
ライブラリーパックの更新により既存のスクリプトおよびリモートアクションのすべての設定が上書きされ、更新後に再署名が必要になります。 したがって、ライブラリからインストールされたリモートアクションおよびシステムリモートアクションに対して、スクリプトの再署名以外の変更は行わないことをNexthinkは推奨します。
詳細については、Windowsでリモートアクションのためのスクリプトを書く と Macでリモートアクションのためのスクリプトを書く ドキュメントを参照してください。
Remote action scripts have a 600 KB maximum size limit: 
Up to 50 inputs with a maximum total of 30 KB characters.
Up to 50 outputs with value limits depending on the type.
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クエリを使用して定期的に実行をトリガーします。
検索フィールド: リモートアクションの名前を検索することでテーブルをフィルタリングするフィールド。
関連するリモートアクションを選択し、テーブルの右側にあるアクションメニューをクリックして表示します:
詳細: 実行詳細ページを開きます。
設定: ライブラリリモートアクションの構成を変更します。
編集: 選択したリモートアクションを編集します。
タグの編集: リモートアクションタグの作成、割り当て、および編集を行います。 リモートアクションのタグ付け セクションを参照してください。
共有: 他のユーザーにリモートアクションを表示または編集する権限を付与します。 リモートアクションの共有 セクションを参照してください。
NQL IDのコピー: APIで使用するためにリモートアクションのNQL IDをコピーします。
エクスポート: リモートアクションをJSONファイルにエクスポートします。
削除: システムからリモートアクションを削除します。
リモートアクションと関連するタグを作成し、リモートアクションテーブルの結果をすばやくフィルタリングします。
リモートアクションに関連付けられるタグの最大数は10です。
右側のメニューでタグアイコンをクリックして、タグ パネルを開きます。
パネルの上部で特定のタグを検索します。
1つ以上のタグを選択して、リモートアクションテーブルをフィルタリングします。
リモートアクションにタグを追加するには:
Remote Actions > Manage remote actions を選択します。
関連するリモートアクションを選択し、右側のアクションメニューにカーソルを置きます。
アクションメニューアイコンをクリックし、タグの編集 を選択して タグ ポップアップを開きます。
新しい名前を入力するか、タグ フィールドでタグ名を検索します。
タグアクションメニューをクリックしてタグの色を変更するか削除します。
保存 をクリックしてタグをリモートアクションに追加します。
タグを削除すると、選択したリモートアクションからのみ削除されます。
リモートアクションをプロファイルと共有し、ダッシュボードの表示、編集の実行、およびリモートアクションの実行に適切な権限を付与します。 例えば、 Get Battery Status リモートアクションを Service desk プロファイルと共有し、リモートアクションダッシュボードを表示および実行する権限を含めることができます。 Manage All Remote Actions 機能の権限が有効なユーザーのみが 共有 オプションを表示できます。 詳細については、Remote Actionsを使用した開始ドキュメントを参照してください。
リモートアクションにカーソルを合わせてアクションメニューを表示し、共有を選択します。 共有リモートアクションモーダルが開きます。
プロファイルの追加 テキストフィールドに、リモートアクションを共有したいユーザープロファイルを入力します。
権限の選択 ドロップダウンメニューから、プロファイルに適切な権限を選択します。 選択肢は以下の通りです:
ダッシュボードを表示: ナビゲーションパネルおよび概要ページのリモートアクションテーブルからリモートアクションダッシュボードにアクセスします。
編集: リモートアクションを編集します。
実行: リモートアクションを実行します。
全てをクリアをクリックして、すべての権限を無効にします。
権限を付与ボタンをクリックしてリモートアクションを共有します。
ハードドライブからリモートアクションをインポートするには：
ページ右上にあるインポートボタンをクリックしてリモートアクションをインポートします。 有効なファイル形式はJSONです。
ハードドライブからファイルを選択し、システムにインポートします。 ファイルはリモートアクションのリストに表示されます。
Nexthink Libraryからリモートアクションをインポートするには：
インポートボタンの隣にあるアクションメニューをクリックします。
Nexthink Libraryを選択します。 システムはリモートアクションをダウンロードするためのライブラリページにリダイレクトします。
ダウンロードしたファイルをインポートします。
調査ページでNQLクエリの結果からオンデマンドでリモートアクションを実行します。 これは単一のターゲットデバイス、複数のデバイス、またはすべてのデバイスで行うことができ、リモートアクションが複数の実行を許可するように設定されているかどうかによります。
メインメニューから調査を選択します。
NQLエディタを使用して、関心のあるデバイスのリストを返すクエリを入力します。
クエリを実行するために実行ボタンをクリックします。
リモートアクションを実行したい単一または複数のデバイスを選択するか、最初の列の上にあるチェックボックスを使用してすべてのデバイスを選択します。
すべてのデバイスを選択する
アクションバーからリモートアクションを実行を選択します。 使用可能なリモートアクションのリストを含むモーダルが表示されます。
リモートアクションを選択し、実行ボタンをクリックします。
大量のデバイスに対してリモートアクションを実行する際、ユーザーインターフェースで表示されるレコードの数が10,000件に制限されるため、Nexthinkでは実行結果をエクスポートすることを推奨します。
Amplifyからトリガーされたすべてのリモートアクションを追跡し、remote_action.executionsテーブルのフィールドをフィルタリングします。 トリガーされたリモートアクションデータにアクセスするには、これらのフィールドをNQLクエリに含めます。
trigger_method: リモートアクション実行を開始するのに使用したトリガーモード。
internal_source: リモートアクションをトリガーするために使用したNexthinkモジュール。
external_reference: チケットを追跡するために使用する参照ID。
external_source: リモートアクションが実行された外部webアプリケーションレコードの識別子。
テーブルはremote_action.executionsで実行されたNQLクエリの結果に基づいて編成されています。
リモートアクションのNQLの例を参照してください。
関連トピック
