カスタムスクリプトの概要

カスタムスクリプトとは?

Kandjiのカスタムスクリプトは、Macコンピュータでタスクを自動化し、設定を構成するための強力な方法です。これらは、Kandji Agentを使用して登録済みデバイスに展開および実行できる一連の命令と考えてください。カスタムスクリプトを使用すると、デバイス設定の構成、ソフトウェアアプリケーションのインストールまたは更新、メンテナンスタスクの実行、セキュリティポリシーの適用を行うことができます。また、カスタムスクリプトを使用して、ハードウェアインベントリやシステムログなどのデバイス情報を収集することもできます。事前に構築された、定期的に保守されるスクリプトのコレクションは、GitHub リポジトリで入手できます。

Kandjiのカスタムスクリプトライブラリアイテムは、さまざまな言語でスクリプトをデプロイできます。ただし、当社のサポートチームは、主にshell、bash、zshell、またはPythonで記述されたスクリプトのトラブルシューティングに対応しています。またAppleScriptは、サポートされている言語のいずれかによって呼び出された場合に限り、サポート可能です。

カスタムスクリプトのしくみ

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

実行頻度

デプロイするスクリプトに応じて、チェックインのたびに 1 回実行するか、1 日 1 回実行するか、 Self Serviceからオンデマンドで実行するかを指定できます。 

  • デバイスごとに 1 回インストール: スクリプトはデバイスごとに 1 回実行されます。スクリプトが失敗した場合は、成功するまで、次のチェックインで自動的に再試行されます。

  • 15 分ごとに実行: スクリプトはチェックインのたびに (~ 15 分ごとに) 実行されます。

  • 毎日実行: スクリプトは、前回の実行時間に基づいて 24 時間ごとに実行されます。

    • カスタムスクリプト Library Item は、上記の3つのシナリオで Self Service を介して追加で提供できます。

  • Self Serviceからオンデマンドで実行: スクリプトは自動的に実行されることはなく、 Self Serviceからのオプション項目としてのみ提供されます。アイテムを実行すると、[実行] ボタンのラベルが [再実行] に変わります。

終了コードと出力

  • スクリプトが終了コード 0 で終了した場合、そのスクリプトは成功と見なされます。0 以外の終了コードで終了した場合は、 アラート/失敗と見なされます。

  • Stdout と Stderr は、デバイスのステータスページまたはカスタムスクリプトのステータスページにあるスクリプトの監査情報に記録されます。 

修復と再起動のオプション

  • 修復スクリプトを使用すると、 メインの監査スクリプト を純粋な監査スクリプトとして活用して、システム構成またはアプリケーションの状態を確認できます。この監査スクリプトが 0 以外の終了コードで終了した場合、これは監査エラーと見なされ、修復スクリプトが実行されます。

    • その後、修復スクリプトが終了コード 0 で終了した場合、そのデバイスのライブラリアイテムの状態は [修復済み] になります。修復スクリプトが失敗した場合、そのデバイスのライブラリアイテムのステータスは アラートになります。

  • 再起動オプションを使用すると、スクリプトが正常に実行された後に強制的に再起動を行うことができます。このオプションを選択すると、ユーザーは Kandji Agent メニューバーアプリケーションから再起動タイマーを受け取ります。このタイマーは、アイテムが Self Service から開始された場合は5分間の再起動タイマー、チェックイン中など別の方法で開始された場合は30分間の再起動タイマーとなります。再起動オプションの挙動は、修復スクリプトの使用状況によって異なります。

    • 修復スクリプトが利用されている場合:修復スクリプトが 0 で終了すると、再起動のカウントダウンがトリガーされます。 

    • 修復スクリプトが活用されていない場合 監査スクリプトが 0 で終了すると、再起動のカウントダウンがトリガーされます。 

カスタムスクリプトライブラリアイテムを追加する

  1. 左側のナビゲーションバーで [ライブラリ]に移動します。

  2. 右上の「新規追加」をクリックし、「カスタムスクリプト」を選択します。

  3. 「追加と設定」をクリックします。

  4. 新しいカスタムスクリプトライブラリアイテmじゅに名前を付けます。 

  5. ご希望の Assignment Maps または Classic Blueprintsに割り当てます。 

  6. 必要に応じて、Classic Blueprintsの 割り当て ルールを設定します。

  7. 実行頻度を選択します。

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

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

  10. 必要に応じて、 修復スクリプトを構成して貼り付けます。

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

  12. 「保存」をクリックします。