> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# エージェントのチェックインのトラブルシューティング

> macOSとWindowsでのIru Agentのチェックインの失敗を診断して解決します。ネットワークの問題、証明書のエラー、接続の問題をトラブルシューティングします。

<Callout icon="list-check" color="#B84A7A" iconType="regular">このガイドはMacコンピュータとWindowsコンピュータに適用されます</Callout>

### エージェントのチェックインの問題について

Iru Endpointに登録されているmacOSおよびWindowsコンピュータは、さまざまな管理タスクにIru Agentを使用します。エージェントは15分ごとにチェックインを試みます。デバイスが期待どおりにチェックインしない場合は、次の手順で通信を回復できる場合があります。

<Note>
  **2026年4月8日**をもって、アプリのブランドが**Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" />から**Iru** <img src="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" alt="" style={{ display: 'inline', height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 -0.08em 0 0', padding: 0 }} width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg" />に更新されました。アプリ名は**Kandji Self Service**から**Iru Self Service**に、**Kandji Agent**から**Iru Agent**に変更されました。手動登録ポータルでもIruのブランドが使用されるようになりました。古いアプリ名を参照している**スクリプト、自動化、ユーティリティ**を更新してください。
</Note>

### 仕組み

Iru AgentはIru Endpointサーバーと通信し、構成の更新、ポリシーの変更、アプリケーションの展開を受け取ります。チェックインが失敗すると、デバイスが重要な更新を受け取れず、コンプライアンスの問題や古い構成につながる可能性があります。

### インターネット接続を確認する

デバイスがアクティブなインターネット接続を持ち、[エンタープライズネットワークでのIruの使用](/ja/iru/requirements/using-iru-on-enterprise-networks)に記載されているドメインとポートにアクセスできることを確認します。

簡単なトラブルシューティングの手順として:

* デバイスをモバイルホットスポットなどの別のネットワークに接続してみます
* チェックインが再開した場合、問題は元のネットワークのフィルタリングまたはファイアウォールの構成にある可能性があります

### プラットフォーム固有のトラブルシューティング

<Tabs>
  <Tab title="macOS" icon="apple" iconType="brands">
    ### チェックインを強制する(macOS)

    #### Self Service

    * エンドユーザーは**Iru Self Service**を開き、**Device Info**に移動して**同期**を選択できます

    #### コマンドライン

    * **ターミナル**で次のコマンドを実行して、チェックインを強制します。

    ```bash theme={null}
    sudo iru run -F
    ```

    出力に追加の詳細が表示される場合があります。

    ### Iru Agentを再インストールする

    macOSでは、IruウェブアプリからIru Agentを再インストールできます。

    <Steps>
      <Step title="デバイスレコードにアクセスする">
        Iruウェブアプリでデバイスレコードに移動します
      </Step>

      <Step title="Agentを再インストールする">
        デバイスアクションメニューから**Reinstall Agent**を選択します
      </Step>

      <Step title="インストールの状態を監視する">
        **アクティビティ**タブで状態を監視します。`InstallEnterpriseApplication` MDMコマンドを探します
      </Step>
    </Steps>

    <Note>
      コマンドが**NotNow**(デバイスがビジー状態)を返す場合:

      * Macにユーザーがログインしていて電源に接続されていることを確認してから、再試行してください。[Appleの開発者向けドキュメント](https://developer.apple.com/documentation/devicemanagement/implementing_device_management/handling_notnow_status_responses)を参照してください
    </Note>

    ### 再起動に関する考慮事項

    * 再起動後、macOSがアップデートやバックグラウンドタスクを完了できるように、Iruはチェックインまで最大30分待機する場合があります

    ### エージェントの状態の確認

    エージェントの状態を確認します。

    ```bash theme={null}
    sudo iru library --state
    ```
  </Tab>

  <Tab title="Windows" icon="microsoft" iconType="brands">
    ### チェックインを強制する(Windows)

    #### Iru Agentサービスを再起動する

    * **Windows**アイコンを右クリックし、**Run**を選択します
    * `services.msc`と入力し、**Enter**キーを押します
    * サービスの一覧で**Iru Agent**を見つけます
    * **Iru Agent**を右クリックし、**再起動**を選択します

    これにより、即座にチェックインが強制されます。

    #### コマンドライン

    * 管理者として**PowerShell**で次のコマンドを実行します。

    ```powershell theme={null}
    dsregcmd /status
    ```

    ### Iru Agentを再インストールする

    Windowsでは、新しいアプリやポリシーをデバイスにプッシュするか、再登録してエージェントがインストールされるようにします。

    ### 再起動に関する考慮事項

    * チェックインは通常、15分間のAgentのサイクル内で再開します

    ### エージェントのログを確認する

    エージェントのログは次の場所にあります。

    ```
    %ProgramData%\kandji\agent\logs
    ```

    ### エージェントの状態の確認

    エージェントの状態は次の場所で確認します。

    * **設定** > **アカウント** > **Access work or school**
    * **Event Viewer** > **Applications and Services Logs** > **Microsoft** > **Windows** > **DeviceManagement-Enterprise-Diagnostics-Provider**
  </Tab>
</Tabs>

### 再起動

デバイスを再起動すると、停止したプロセスが解消され、Iru Agentが通常のチェックインを再開できる場合があります。

### 再登録

上記の手順で問題が解決しない場合は、デバイスを手動で再登録します。

<Steps>
  <Step title="既存の登録を削除する">
    既存のMDM登録を削除します
  </Step>

  <Step title="デバイスを再登録する">
    正しい**登録コード**を使用して再登録します
  </Step>
</Steps>

<Note>
  デバイスを登録する際は、正しいBlueprintが選択されていることを確認してください。別のBlueprintが選択された場合、デバイスにはそのBlueprintに割り当てられたLibrary Itemsとパラメータが適用されます。再登録後にデバイスレコードが重複することはありません。Iru Endpointは新しい登録を既存のデバイスレコードに関連付けます。
</Note>

### 高度なトラブルシューティング

ログで次の点を確認します。

* インストールエラー
* ポリシーの失敗
* 通信の問題
* ネットワーク接続の問題

### ネットワーク診断

<Steps>
  <Step title="接続をテストする">
    ネットワーク診断ツールを使用して、Iruサービスへの接続をテストします
  </Step>

  <Step title="ファイアウォールを確認する">
    ファイアウォールのルールでIruドメインとの通信が許可されていることを確認します
  </Step>

  <Step title="DNSをテストする">
    IruドメインのDNS名前解決が機能していることを確認します
  </Step>

  <Step title="プロキシを確認する">
    該当する場合は、プロキシの設定を確認します
  </Step>
</Steps>

### 一般的な問題と解決策

<AccordionGroup>
  <Accordion title="エージェントが応答しない">
    **症状:**

    * Iruでデバイスがオフラインと表示される
    * デバイスレコードに最近のチェックインがない
    * ポリシーが適用されない

    **解決策:**

    * インターネット接続を確認する
    * デバイスを再起動する
    * 手動でチェックインを強制する
    * 必要に応じてエージェントを再インストールする
  </Accordion>

  <Accordion title="チェックインが失敗する">
    **症状:**

    * エージェントのログにエラーメッセージがある
    * ネットワーク接続の問題
    * ファイアウォールが通信をブロックしている

    **解決策:**

    * ネットワーク接続を確認する
    * ファイアウォールのルールを確認する
    * 別のネットワークでテストする
    * エージェントのログで具体的なエラーを確認する
  </Accordion>

  <Accordion title="エージェントのインストールの問題">
    **症状:**

    * 登録後にエージェントがインストールされていない
    * ログにインストールエラーがある
    * デバイスがIruに表示されない

    **解決策:**

    * デバイスが要件を満たしていることを確認する
    * 登録中のネットワーク接続を確認する
    * インストールログを確認する
  </Accordion>
</AccordionGroup>

### ベストプラクティス

<CardGroup cols={2}>
  <Card title="定期的に監視する" icon="eye">
    デバイスのチェックインのステータスを定期的に監視し、問題を早期に特定します
  </Card>

  <Card title="接続をテストする" icon="wifi">
    管理対象デバイスからIruサービスへのネットワーク接続をテストします
  </Card>

  <Card title="ログを確認する" icon="file-text">
    エージェントのログを定期的に確認して、潜在的な問題を見つけます
  </Card>

  <Card title="問題を記録する" icon="book">
    繰り返し発生する問題とその解決策を記録し、今後の参考にします
  </Card>
</CardGroup>
