---
title: "Kandji Agent コマンドラインインターフェース"
slug: "kandji-agent-command-line-interface"
updated: 2025-03-18T12:39:46Z
published: 2025-03-18T12:39:46Z
canonical: "support.kandji.io/kandji-agent-command-line-interface"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.kandji.io/kb/llms.txt
> Use this file to discover all available pages before exploring further.

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

この Kandji Agent は、管理者がデバイスのフリートに追加の制御と情報を提供する一連の強力なターミナル コマンドを提供します。一部のコマンドはターミナルを使用してデバイス上でローカルにしか実行できませんが、他のコマンドはカスタムスクリプト Library Item を使用してデプロイできるため、柔軟性が向上します。

### ローカル専用コマンド

次のコマンドは、ターミナルのデバイス上で直接実行する必要があります。カスタムスクリプトや Custom App Library Itemを使用してデプロイすることはできません。

#### 走る

エージェントが実行され、すぐにチェックインされます。通常、エージェントは 15 分ごとにチェックインします。インターネットに接続されていない場合、エージェントはオフライン モードで実行されます。

```bash
sudo kandji run
```

run コマンドに --reset-daily を追加すると、1 日に 1 回だけ実行されるものを含むすべての Parametersが実行されます。

```bash
sudo kandji run --reset-daily
```

#### 毎日の MDM インベントリ更新の実行

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

```bash
sudo kandji update-mdm
```

#### アプリの収集

Macからすべてのアプリケーションインベントリを収集します。

```bash
sudo kandji collect-apps
```

#### Library Itemsを実行

実行するライブラリ項目を確認します。

```bash
sudo kandji library
```

使用可能な *ライブラリ* コマンド オプション:

| **オプション** | **形容** |
| --- | --- |
| `--list` | コンピュータに割り当てられているすべてのライブラリ項目を一覧表示します。 |
| `--state` | Kandji Agent ライブラリ マネージャーの現在の状態を取得します。 |
| `--item` | 特定のライブラリ項目を名前またはライブラリ項目 ID で実行します。 *-F* を指定して、実行を強制します。 |
| `--cancel` | 現在実行中のライブラリ項目をキャンセルし、現在のキューをクリアします。 |

#### Kandjiログの印刷

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

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

```bash
sudo kandji logs --last <seconds>
```

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

| **オプション** | **形容** |
| --- | --- |
| `--no-format` | ANSI カラー書式なしでログエントリを印刷します。 |
| `--debug` | デバッグ レベルのログが含まれているため、デバッグ ログを事前に有効にする必要があります。 |

デバッグログを有効にします。

```bash
sudo log config --mode "level:debug" --subsystem io.kandji.KandjiAgent
```

デバッグ ログを無効にします。

```bash
sudo log config --mode "level:default" --subsystem io.kandji.KandjiAgent
```

debug logging コマンドの使用例。

```bash
sudo kandji logs --no-format --debug --last 10000 >~/Desktop/kandji.log
```

#### 逸らす

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

```bash
sudo kandji avert --list-quarantine
```

隔離されたファイルを削除します。

```bash
sudo kandji avert --delete-quarantine
```

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

これらのコマンドは、カスタムスクリプトまたは Custom App Library Itemを使用して実行できます。また、Macのターミナルでローカルに実行することもできます。

> [!WARNING]
> カスタムスクリプト Library Item内など、以下のスクリプト可能なオプションを使用する場合は、 **sudo kandji** をバイナリへのフルパス /usr/local/bin/kandji に置き換える必要があります

#### リブート

このオプションは、スクリプト化されたワークフローで使用して、 Kandji Agent およびメニューバーアプリケーションを利用して再起動を強制できます。これは、 FileVault の有効化または Managed OS アップグレード中に強制される再起動と視覚的に似ています。

これにより、ログインしているユーザーにカウントダウンタイマーを促すことで再起動が開始されます。遅延が指定されていない場合は、デフォルトの 1800 (30 分) が使用されます。ログインしているユーザーがいない場合、遅延は無視され、Macはすぐに再起動します。

```bash
sudo kandji reboot --delaySeconds NumberOfSeconds
```

ユーザーに遅延のオプションを提供せずに、強制的に再起動します。

```bash
sudo kandji reboot --no-deferral
```

#### ドック

このオプションは、スクリプト化されたワークフローで、 macOS ドックの末尾にアイテムを追加したり、現在ログインしているユーザーの macOS ドックからアイテムを削除したりするために使用できます。

バンドル識別子で参照されるアプリケーションは、/Applications フォルダにある必要があります。

オプションで *--all* オプションを指定すると、すべてのユーザーアカウントの Dock の末尾にアイコンが追加されます。

```bash
sudo kandji dock [--add bundle identifier] [--remove bundle identifier] [--all]
```

一度に複数のオプションを使用する場合は、1 つのコマンドを使用し、次の例に示すように、引用符とスペースで区切ってオプションを区切ります。

```bash
/usr/local/bin/kandji dock --add "com.google.Chrome us.zoom.xos com.tinyspeck.slackmacgap"
```

#### アラート

このコマンドは、スクリプト化されたワークフローで使用して、ユーザーにアラートを表示できます。

```bash
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 Sequoiaエクスペリエンスの例です。

```bash
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
```

![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-01-02.png)

#### 診断の送信

[診断を Kandjiに送信します](/v1/docs/ja/how-to-submit-kandji-agent-diagnostics)。Kandjiメニューにあるアクションメニュー(歯車)の項目に相当します。

```bash
sudo kandji submit-diagnostics [--comment text]
```

使用可能な submit-diagnostics コマンドオプション:

| **オプション** | **形容** | **指定しない場合のデフォルト** |
| --- | --- | --- |
| `--comment` | 診断に表示するコメントを指定します | デフォルト値なし |

#### バージョン

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

```bash
sudo kandji version
```

#### ヘルプ

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

```bash
sudo kandji help
```