Kandji AgentはMacにインストールした後は主にハンズオフですが、追加の制御のためにいくつかのターミナルコマンドを使用できます。
Run
sudo kandji run
エージェントが実行され、すぐにチェックインされます。通常、エージェントは 15 分ごとにチェックインします。インターネットに接続されていない場合、エージェントはオフラインモードで実行されます。
sudo kandji run --reset-daily
run コマンドに --reset-daily を追加すると、1 日に 1 回だけ実行されるものを含むすべての Parametersが実行されます。
毎日の MDM インベントリ更新の実行
sudo kandji update-mdm
エージェントは、MDM サーバーに対して、Apple Business Managerからの Apps & Books の検証や特定のデバイス情報のクエリなど、日常的なMDMコマンドを開始するように要求します。
アプリの収集
sudo kandji collect-apps
Macからすべてのアプリケーションインベントリを収集します。
ライブラリアイテムを実行
sudo kandji library
実行するライブラリアイテムを確認します。使用可能なライブラリ コマンド オプション:
オプション | 概要 |
---|---|
| コンピュータに割り当てられているすべてのライブラリアイテムを一覧表示します。 |
| Kandji Agent ライブラリマネージャーの現在の状態を取得します。 |
| 特定のライブラリアイテムを名前またはライブラリアイテム ID で実行します。 -F を指定して、実行を強制します。 |
| 現在実行中のライブラリアイテムをキャンセルし、現在のキューをクリアします。 |
Kandjiログの印刷
sudo kandji logs --last <seconds>
統合ロギングシステムから Kandji Agent サブシステムのログエントリを印刷します。'--last' オプションは 必須 で、ログを印刷する前の秒数を指定します。<seconds> を 300 などの数値に置き換えます。(表示される実際の結果は、使用可能な統合ログストレージに基づいて制限されます。
> を使用してコマンドの出力をリダイレクトし、外部ログファイルに保存します。
使用可能な logs コマンドオプション:
オプション | 概要 |
---|---|
| ANSI カラー書式なしでログエントリを印刷します。 |
| デバッグレベルのログが含まれているため、デバッグ ログを事前に有効にする必要があります。 |
https://portal.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/document/v1/view/0efb9029-0c88-498f-8e69-de0b07345c2b/de
sudo log config --mode "level:debug" --subsystem io.kandji.KandjiAgent
デバッグログを有効にします。
sudo log config --mode "level:default" --subsystem io.kandji.KandjiAgent
デバッグ ログを無効にします。
sudo kandji logs --no-format --debug --last 10000 >~/Desktop/kandji.log
debug logging コマンドの使用例。
Avert
sudo kandji avert --list-quarantine
隔離されたファイルを一覧表示します。
sudo kandji avert --delete-quarantine
隔離されたファイルを削除します。
スクリプト可能なオプション: 再起動
sudo kandji reboot --delaySeconds NumberOfSeconds
このオプションは、スクリプト化されたワークフローで使用して、 Kandji Agent およびメニューバーアプリケーションを利用して再起動を強制できます。これは、 FileVault の有効化または Managed OS アップグレード中に強制される再起動と視覚的に似ています。
これにより、ログインしているユーザーにカウントダウンタイマーを促すことで再起動が開始されます。遅延が指定されていない場合は、デフォルトの 1800 (30 分) が使用されます。ログインしているユーザーがいない場合、遅延は無視され、Macはすぐに再起動します。
sudo kandji reboot --no-deferral
ユーザーに遅延のオプションを提供せずに、強制的に再起動します。
カスタムスクリプト Library Item内など、以下のスクリプト可能なオプションを使用する場合は、バイナリへのフルパス /usr/local/bin/kandji を使用する必要があります
スクリプト可能なオプション: Dock
sudo kandji dock [--add bundle identifier] [--remove bundle identifier] [--all]
このオプションは、スクリプト化されたワークフローで、 macOS Dock の末尾にアイテムを追加したり、現在ログインしているユーザーの macOS Dock からアイテムを削除したりするために使用できます。
バンドル識別子で参照されるアプリケーションは、/Applications フォルダにある必要があります。
オプションで --all オプションを指定すると、すべてのユーザーアカウントの Dock の末尾にアイコンが追加されます。
一度に複数のオプションを使用する場合は、1 つのコマンドを使用し、次の例に示すように、引用符とスペースで区切ってオプションを区切ります。
/usr/local/bin/kandji dock --add "com.google.Chrome us.zoom.xos com.tinyspeck.slackmacgap"
スクリプト可能なオプション: アラート
sudo kandji display-alert [--title text] [--message text] [--icon path_to_image] [--suppression-key string] [--help-url url] [--no-wait]
このコマンドは、スクリプト化されたワークフローで使用して、ユーザーにアラートを表示できます。以下に概説するいくつかのオプションがあります。
オプション | 概要 | 指定しない場合のデフォルト |
---|---|---|
| アラート ウィンドウのカスタムタイトルを指定します | 「アラート」 |
| アラート ウィンドウのカスタムメッセージを指定します | デフォルト値なし |
| アラートウィンドウのカスタムアイコンを指定します。.jpg、.png、または.icnsファイルを使用することをお勧めします。 | Kandji Agent アイコン |
| 指定した場合、ユーザーに「このメッセージを今後表示しない」というオプションが表示されます。 この抑制キーが将来のアラートで提供され、ユーザーが再度表示しないことを選択した場合、アラートは表示されません。 | デフォルト値なし 抑制キーが指定されていない場合、[今後このメッセージを表示しない] オプションは表示されません。 |
| アラートの [ヘルプ] ボタンのカスタム URL を指定できます。 HTTPS URL である必要があります。 | デフォルト値なし URLが指定されていない場合、[ヘルプ]ボタンは表示されません。 |
| アラートの表示を許可しますが、アラートに対するユーザーの操作を待たずにスクリプトの残りの部分を実行し続けます。 | アラートが表示され、スクリプトが進行する前にユーザーからの操作を待ちます。 |
以下は、アラートの基になるコマンドと、その結果の macOS Venturaエクスペリエンスの例です。
sudo /usr/local/bin/kandji display-alert --title "Low Disk Space" --message "Your Mac computer's Hard Drive is running critically low on space, please contact Accuhive IT as soon as possible." --suppression-key accuhive --help-url https://kandji.io --no-wait
診断の送信
sudo kandji submit-diagnostics [--comment text]
診断を Kandjiに送信します。Kandjiメニューにあるアクションメニュー(歯車)の項目に相当します。
オプション | 概要 | 指定しない場合のデフォルト |
---|---|---|
| 診断に表示するコメントを指定します | デフォルト値なし |
バージョン
sudo kandji version
インストールされている Kandji Agent バージョンを表示します。
ヘルプ
sudo kandji help
ヘルプテキストを表示します。