Skip to main content
このガイドは Mac コンピュータに適用されます

​
Iru Agent CLI について

Iru Agent には、管理者がデバイス群をより細かく制御し、より多くの情報を得られる強力な Terminal コマンド群が用意されています。一部のコマンドは Terminal を使用してデバイス上でローカルにのみ実行できますが、その他のコマンドは柔軟性を高めるために Custom Script Library Item を通じて展開することもできます。
2026 年 4 月 8 日をもって、アプリは Kandji から Iru のブランドに更新されました。Agent アプリの名前は Kandji Agent から Iru Agent に変更されました。古いアプリ名を参照しているスクリプト、自動化、ユーティリティを更新してください。

​
ローカル専用のコマンド

次のコマンドは、デバイス上の Terminal で直接実行する必要があります。Custom Script や Custom App Library Item を介して展開することはできません。

​
インタラクティブモード (TUI)

サブコマンドもオプションも指定せずに sudo iru を実行すると、ターミナルユーザーインターフェイス (TUI) が開きます。これは Terminal 内のフルスクリーンのメニュー駆動型フローで、完全なコマンドやフラグを入力しなくても、一般的なエージェントのアクションを参照して実行できます。
Terminal

​
Run

エージェントが実行され、すぐにチェックインします。通常、エージェントは 15 分ごとにチェックインします。インターネットに接続されていない場合、エージェントはオフラインモードで実行されます。
Terminal
過去 24 時間以内にすでに実行されている場合でも、毎日のエージェント処理を強制的に実行するには、--reset-daily を追加します:
  • Blueprint の Parameters: 毎日の Parameters は、過去 24 時間以内にすでに実行されている場合でも実行されます。
  • カスタムスクリプト: チェックインごとに実行されるスクリプトや継続的に強制適用されるスクリプトだけでなく、実行頻度が毎日の Custom Scripts も実行されます。
  • アプリのインベントリ: 1 日 1 回のインベントリのスケジュールを無視して、アプリケーションのインベントリ (MDM コマンドを含む) を収集します。
Terminal

​
毎日の MDM インベントリ更新を実行する

エージェントは MDM サーバーに対して、Apple Business や Apple School Manager の Apps & Books の検証や、特定のデバイス情報の照会など、毎日の MDM コマンドを開始するよう要求します。
Terminal

​
アプリを収集する

Mac からアプリケーションの完全なインベントリを収集します。
Terminal

​
Library Items を実行する

実行する Library Items を確認します。
Terminal
スケジュールされていない場合でも単一の Library Item を強制的に実行するには、--item と --reset-daily (-F と同じ) を使用します:
Terminal
library コマンドで使用できるオプション:

​
Iru Agent のログを出力する

統合ログシステムから Iru Agent サブシステムのログエントリを出力します。--last オプションは必須で、何秒前までのログを出力するかを指定します。<seconds> を 300 などの数値に置き換えます。(実際に表示される結果は、利用可能な統合ログのストレージによって制限されます。) 外部のログファイルに保存するには、> を使用してコマンドの出力をリダイレクトします。
Terminal
logs コマンドで使用できるオプション:
統合ログは製品のブランディングとは別のものです。以下の例のように、Mac 上のサブシステム識別子は、log show の述語および log config --subsystem で引き続き io.kandji プレフィックスを使用します。システムが記録する内容とコマンドが一致するように、これらの文字列を使用してください。
ログサブシステムセクションに一覧表示されているサブシステムのデバッグログを有効にします。
Terminal
デバッグログのコマンドの使用例。
Terminal
ログサブシステム Iru Agent で利用できるログサブシステムにより、きめ細かく対象を絞ったログ記録が可能です。 サブシステムの述語を使用したログコマンド。
Terminal
述語を使用したログコマンドで使用できるオプション: オプションを指定したサブシステムの述語によるログコマンド。
Terminal
利用可能なログサブシステム:
  • io.kandji.beekeeper
  • io.kandji.cli
  • io.kandji.daemon
  • io.kandji.installer
  • io.kandji.library-manager
  • io.kandji.menu
  • io.kandji.passport
  • io.kandji.parameter-agent
  • io.kandji.self-service
  • io.kandji.liftoff

​
EDR

隔離されたファイルを一覧表示します。
Terminal
隔離されたファイルを削除します。
Terminal

​
スクリプト化可能なコマンド

これらのコマンドは、Custom Script または Custom App Library Item を通じて実行できます。また、Mac 上の Terminal でローカルに実行することもできます。
Custom Script Library Item 内など、以下のスクリプト化可能なオプションを使用する場合は、sudo iru をバイナリへのフルパス /usr/local/bin/iru に置き換える必要があります

​
再起動

このオプションは、スクリプト化されたワークフローで、Iru Agent とメニューバーアプリケーションを利用して再起動を強制するために使用できます。見た目は、FileVault の有効化時や Managed OS のアップグレード時に強制される再起動と似ています。 ログインしているユーザーにカウントダウンタイマーを表示して、再起動を開始します。遅延が指定されていない場合は、デフォルトの 1800 (30 分) が使用されます。ログインしているユーザーがいない場合、遅延は無視され、Mac はすぐに再起動します。 <seconds> をカウントダウンの長さ (秒単位) に置き換えます (例: 5 分の場合は 300)。
Terminal
ユーザーに延期の選択肢を与えずに再起動を強制します。
Terminal

​
Dock

このオプションは、スクリプト化されたワークフローで、現在ログインしているユーザーの macOS Dock の末尾に項目を追加したり、macOS Dock から項目を削除したりするために使用できます。 バンドル識別子で参照されるアプリケーションは、/Applications フォルダにある必要があります。 オプションで —all オプションを指定すると、すべてのユーザーアカウントの Dock の末尾にアイコンが追加されます。
Terminal
複数のオプションを同時に使用する場合は、以下の例のように、単一のコマンドを使用し、引用符で囲んでスペースで区切ってください。
Terminal

​
アラート

このコマンドは、スクリプト化されたワークフローでユーザーにアラートを表示するために使用できます。
Terminal
以下のようなオプションがあります。 以下は、アラートの基になるコマンドと、macOS Tahoe での表示結果の例です:
Terminal
display-alert コマンドの実行後に macOS Tahoe に表示された、Low Disk Space のタイトル、警告メッセージ、Help ボタン、OK ボタンを含むアラートダイアログ

​
診断情報を送信する

Iru Endpoint に診断情報を送信します。Iru メニューのアクションメニュー (歯車アイコン) の項目と同等です。
Terminal
submit-diagnostics コマンドで使用できるオプション:

​
バージョン

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

​
ヘルプ

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