Kandji Agent コマンドラインインターフェース

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

実行するライブラリアイテムを確認します。使用可能なライブラリ コマンド オプション:

オプション

概要

--list

コンピュータに割り当てられているすべてのライブラリアイテムを一覧表示します。

--state

Kandji Agent ライブラリマネージャーの現在の状態を取得します。

--item

特定のライブラリアイテムを名前またはライブラリアイテム ID で実行します。 -F を指定して、実行を強制します。

--cancel

現在実行中のライブラリアイテムをキャンセルし、現在のキューをクリアします。

Kandjiログの印刷

sudo kandji logs --last <seconds>

統合ロギングシステムから Kandji Agent サブシステムのログエントリを印刷します。'--last' オプションは 必須 で、ログを印刷する前の秒数を指定します。<seconds> を 300 などの数値に置き換えます。(表示される実際の結果は、使用可能な統合ログストレージに基づいて制限されます。

> を使用してコマンドの出力をリダイレクトし、外部ログファイルに保存します。

使用可能な logs コマンドオプション:

オプション

概要

--no-format

ANSI カラー書式なしでログエントリを印刷します。

--debug

デバッグレベルのログが含まれているため、デバッグ ログを事前に有効にする必要があります。

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]

このコマンドは、スクリプト化されたワークフローで使用して、ユーザーにアラートを表示できます。以下に概説するいくつかのオプションがあります。

オプション

概要

指定しない場合のデフォルト

--title

アラート ウィンドウのカスタムタイトルを指定します

「アラート」

--message

アラート ウィンドウのカスタムメッセージを指定します

デフォルト値なし

--icon

アラートウィンドウのカスタムアイコンを指定します。.jpg、.png、または.icnsファイルを使用することをお勧めします。

Kandji Agent アイコン

--suppression-key

指定した場合、ユーザーに「このメッセージを今後表示しない」というオプションが表示されます。

この抑制キーが将来のアラートで提供され、ユーザーが再度表示しないことを選択した場合、アラートは表示されません。

デフォルト値なし

抑制キーが指定されていない場合、[今後このメッセージを表示しない] オプションは表示されません。

--help-url

アラートの [ヘルプ] ボタンのカスタム URL を指定できます。

HTTPS URL である必要があります。

デフォルト値なし

URLが指定されていない場合、[ヘルプ]ボタンは表示されません。

--no-wait

アラートの表示を許可しますが、アラートに対するユーザーの操作を待たずにスクリプトの残りの部分を実行し続けます。

アラートが表示され、スクリプトが進行する前にユーザーからの操作を待ちます。


以下は、アラートの基になるコマンドと、その結果の 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メニューにあるアクションメニュー(歯車)の項目に相当します。

オプション

概要

指定しない場合のデフォルト

--comment

診断に表示するコメントを指定します

デフォルト値なし

バージョン

sudo kandji version

インストールされている Kandji Agent バージョンを表示します。

ヘルプ

sudo kandji help

ヘルプテキストを表示します。