Skip to main content
Custom Scripts は Mac コンピュータと Windows コンピュータで利用できます

Custom Script とは

Iru Endpoint のカスタムスクリプトは、管理対象デバイスでタスクを自動化し、設定を構成します。Iru Agent を使用して登録済みデバイスに展開および実行できる一連の指示と考えてください。カスタムスクリプトを使用すると、デバイス設定の構成、ソフトウェアアプリケーションのインストールや更新、メンテナンスタスクの実行、セキュリティポリシーの適用を行えます。また、ハードウェアインベントリやシステムログなどのデバイス情報を収集するためにカスタムスクリプトを使用することもできます。事前に構築され定期的にメンテナンスされているスクリプトのコレクションが、GitHub リポジトリで入手できます。
Iru Endpoint の Custom Script Library Item は、さまざまな言語のスクリプトを展開できます。ただし、サポートチームが最も的確にトラブルシューティングを支援できるのは、shell、bash、zshell、または Python で書かれたスクリプトです。サポートされている言語のいずれかから呼び出される場合は、AppleScript についても支援できます。

Custom Scripts の仕組み

Iru Agent は、登録済みの Mac コンピュータでカスタムスクリプトを実行します。カスタムスクリプトでは、Mac コンピュータ上の任意のシェルまたはインタープリタを指定できます。シェルまたはインタープリタが指定されていない場合は、デフォルトのシェル(/bin/sh)が使用されます。カスタムスクリプトは常に root ユーザーとして実行されます。

実行頻度

展開するスクリプトに応じて、チェックインごとに実行するか、1 日に 1 回実行するか、Self Service からオンデマンドで実行するかを指定できます。
デバイスごとに1回インストール の場合、Iru はそのデバイスで Library Item が Pass になるまで、チェックインごとに監査スクリプトを再実行します。修復スクリプトが有効で成功した場合、Library Item は 修復済み と表示されることがありますが、Iru は Pass になるまで後続のチェックインで監査スクリプトを再実行します。
スクリプトはチェックインごと(約 15 分ごと)に実行されます。
スクリプトは前回の実行時刻に基づいて 24 時間ごとに実行されます。
スクリプトは自動的に実行されることはなく、Self Service からオプションの項目としてのみ提供されます。項目の実行後、Run ボタンは Run again に変わります。
上記の最初の 3 つのシナリオでも、Custom Script Library Item を Self Service で提供できます。

終了コードと出力

監査スクリプトがコード 0 で終了した場合、その実行は Pass ステータスになります。監査スクリプトが 0 以外の終了コードで終了した場合、その実行は エラー ステータスになります。実行が エラー ステータスになると、Iru はアラートを生成します。詳細については、グローバルアラートのサポート記事を参照してください。
Stdout と Stderr はスクリプトの監査情報に記録され、デバイスのステータスページまたはカスタムスクリプトのステータスページで確認できます。

修復

修復スクリプトを使用すると、メインの 監査スクリプト を、システム設定やアプリケーションの状態を確認するための真の監査スクリプトとして使用できます。監査スクリプトが 0 以外の終了コードで終了した場合、その実行は エラー ステータスになり、Iru は修復スクリプトを実行します。
修復スクリプトがコード 0 で終了した場合、そのデバイスの Library Item ステータスは 修復済み になります。修復スクリプトが 0 以外の終了コードで終了した場合、そのデバイスの Library Item ステータスは エラー になり、Iru はアラートを生成します。詳細については、グローバルアラートのサポート記事を参照してください。

再起動オプション

再起動オプションを使用すると、スクリプトの実行が成功した後に強制的に再起動できます。このオプションを選択すると、ユーザーは Iru Agent メニューバーアプリケーションから再起動タイマーを受け取ります。このタイマーは、項目が Self Service から開始された場合は 5 分、チェックイン時など別の方法で開始された場合は 30 分の再起動タイマーになります。
再起動オプションの動作は、修復スクリプトの使用有無によって異なります。
  • Remediation スクリプトを使用している場合、Remediation スクリプトが 0 で終了すると、再起動のカウントダウンがトリガーされます。
  • Remediation スクリプトを使用していない場合、Audit スクリプトが 0 で終了すると、再起動のカウントダウンがトリガーされます。

Liftoff 設定

Custom Script の下部で Liftoff設定 を展開します。そこに このLibrary Itemを処理 があります。この設定は、Iru Liftoff を基準としてスクリプトをインストールするタイミングを選択します。Automated Device Enrollment と手動登録に適用されます。
  • During Liftoff(デフォルト): Custom Script は Liftoff 中に処理され、完了するまで Liftoff は完了しません。Liftoffで非表示 が選択されていない限り、Install 画面に表示されます。
    • Liftoffで非表示: 選択すると、この Library Item は Liftoff 中に処理されますが、Install 画面には表示されません。処理中、Liftoff は画面下部に 続行する前に、必要な追加構成を処理しています… と表示します。この設定は順序には影響しません。
    • Friendly name(オプション): 指定すると、Liftoff は Library Item の 名前 の代わりにこの名前を表示します。Iru Agent はチェックイン中、引き続き 名前 の順に Library Item を並べます。
  • Liftoff後: Custom Script は Liftoff 中に処理されず、Install 画面にも表示されません。後のエージェントのチェックイン時にインストールされます。
この Custom Script が Automated Device Enrollment Library Item の 設定アシスタント中にLibrary Itemsをインストール にも含まれている場合、設定アシスタント中にもインストールされます。このLibrary Itemを処理 はそのインストールを変更しません。

Custom Script Library Item を追加する

この Library Item を Iru Endpoint の Library に追加するには、Library の概要の記事に記載されている手順に従ってください。
1

Library Item に名前を付ける

新しい Custom Script Library Item に 名前 を付けます。
2

Blueprint に割り当てる

目的の Blueprints に割り当てます。
3

実行頻度を選択する

実行頻度 を選択します。
4

Self Service を設定する(オプション)

必要に応じて、スクリプトを Self Service で利用できるようにします。
5

監査スクリプトを追加する

スクリプトを 監査スクリプト フィールドに貼り付けます。
6

修復スクリプトを追加する(オプション)

必要に応じて、Remediation Script を設定して貼り付けます。
7

再起動オプションを設定する(オプション)

必要に応じて、実行成功後に再起動 チェックボックスをオンにします。
8

Liftoff 設定を構成する(オプション)

Liftoff設定 を展開します。このLibrary Itemを処理 のデフォルトは During Liftoff です。Liftoff の完了後にスクリプトをインストールするには、Liftoff後 を選択します。Liftoff 設定を参照してください。
9

設定を保存する

保存 を選択します。

関連記事

Library の概要

Library Item を選別、作成、管理し、Blueprint に追加します

Blueprint の設定

ポリシー管理のためにデバイスの Blueprint を作成して設定します

カスタムスクリプトを使用した Homebrew の展開

カスタムスクリプトを使用して Mac コンピュータに Homebrew を展開します

グローバル変数

Iru Endpoint でグローバル変数を使用して、デバイスとユーザーの情報をプロファイル、スクリプト、構成設定に動的に挿入する方法を説明します。

グローバルアラート

Custom Scripts やその他の Library Item が問題を報告した際に Iru Endpoint がアラートを表示する方法を設定します