> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/devices/report-realmjoin-agent-contact_scheduled.md).

# RealmJoin エージェント連絡先レポート（スケジュール）

RealmJoin エージェントの報告が停止したデバイスをレポートします

{% hint style="info" %}
これはスケジュール実行の runbook です。単一のオブジェクトによってトリガーされるのではなく、繰り返しスケジュールで実行されるように設計されています。詳細は [スケジューリング](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールを構成する方法の詳細は。
{% endhint %}

### 説明

Windows デバイスについて、RealmJoin が最後にそのデバイスを確認した時刻と、Intune で最後に同期した時刻を比較します。Intune が RealmJoin の最終確認よりかなり後にそのデバイスを確認している場合は、RealmJoin エージェントが見つからない、ブロックされている、または壊れていることを示します。RealmJoin が一度も見たことのないデバイスや、片方にしか認識されていないデバイスも一覧表示できます。レポートはメールで送信することも、ダウンロードリンクとして提供することもできます。

### 仕組み

runbook は 2 つの一覧を読み込み、Entra デバイス ID（代替として Intune デバイス ID）で照合します：

* **Intune**：直近の同期を完了したすべての Windows デバイス *Intune の最終同期から（日数）以内*。Intune との同期を停止したデバイスは意図的に除外されています。それらは **古いデバイスをレポート（スケジュール済み）** runbook に属します。
* **RealmJoin**：RealmJoin customer API のデバイス一覧です。各デバイスについて、RealmJoin エージェントがサインイン済みとして報告したユーザーを保持し、それぞれに *最終検出* タイムスタンプ。RealmJoin はエージェントの各レポートごとに同じタイムスタンプをユーザーとデバイスの両方に書き込むため、これらの値のうち最新のものが、そのデバイスの最後のエージェント接触時刻です。

各 Intune デバイスについて、runbook は次を計算します。 **ギャップ**：RealmJoin エージェントが最後に報告した後、Intune がそのデバイスを何日見続けたか。各デバイスには 1 つのステータスが付きます：

| 状態                 | 意味                                                                                                                                                                                    |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `InSync`           | エージェントは十分最近に報告されています。ギャップは許容値未満です。                                                                                                                                                    |
| `AgentStale`       | Intune はそのデバイスを少なくとも *RealmJoin の最終確認から許容されるギャップ（日数）* エージェントが最後に報告してから後にそのデバイスが見えていました。エージェントが報告していない間もデバイスは使用されていました。つまり、エージェントが見つからない、プロキシまたはファイアウォールでブロックされている、実行されていない、または壊れています。 |
| `NeverSeen`        | RealmJoin はそのデバイスを認識していますが、エージェントがその上でサインイン済みユーザーを一度も報告したことがありません。たとえば、登録されたままで使われていないデバイスや、キオスクなどです。                                                                                 |
| `RealmJoin に存在しない` | そのデバイスは Intune には存在しますが RealmJoin にはありません。エージェントが一度も登録していません。                                                                                                                         |
| `Intune に存在しない`    | そのデバイスは RealmJoin には存在しますが、同期ウィンドウ内に Intune と同期しませんでした。RealmJoin デバイスには照合するためのデバイス名がないため、デバイス名のプレフィックスとは併用できません。                                                                      |

`AgentStale` は常にレポートに含まれます。その他のカテゴリは、 *Include ...* の選択肢です。実行の「Output Data」タブには要約とカテゴリごとの表が 1 つずつ表示され、レポート ファイルにも同じ行が含まれます。

デバイスの主ユーザーが同意しているかどうかと、誰がそこにログオンするかは別の問題です。 **プライマリユーザーの不一致をレポート（スケジュール済み）** runbook がそれらに答えます。

#### なぜギャップであって、経過時間ではないのか

RealmJoin のタイムスタンプを今日と比較すると、たとえば休暇中のように単に電源が切られているだけのデバイスまで列挙されてしまいます。ギャップは 2 つのソース同士を比較します。Intune にも見えていないデバイスは、RealmJoin エージェントの問題ではありません。RealmJoin には何も届いていないのに Intune とは通信し続けているデバイスだけが、エージェントを示します。既定の 14 日は、RealmJoin Portal がデバイスを stale とマークする時点に一致します。

#### RealmJoin のタイムスタンプが意味するもの

RealmJoin エージェントはサインイン中のユーザーのコンテキストで動作し、誰かがサインインしている間は 15 分ごとに報告します。各レポートは次を更新します。 *最終検出* そのデバイス上のそのユーザーと、デバイス自体の両方のタイムスタンプです。サインイン中のユーザーがいないデバイス、たとえばキオスク デバイス、サインイン アカウントのない共有デバイス、または更新のためだけに電源が入っているデバイスは、新しいタイムスタンプを生成せず、次のように表示されることがあります。 `AgentStale` エージェントは正常であるにもかかわらずです。そのようなデバイスは、次を使って除外してください。 *グループからデバイスを除外*、または許容ギャップを大きくします。

次の *最終確認* RealmJoin Portal の列は同じ値ではありません。Portal では、エージェント接触、Intune 同期、Entra ID のサインイン アクティビティのうち最新のものが表示されます。このレポートでは、エージェントが動作しているかどうかを示すのはそれだからという理由で、あえてエージェント接触のみを使用しています。

#### 整合性チェックの行

runbook は RealmJoin 自身のクライアント統計も読み取り、RealmJoin がアクティブと数えるクライアント数を出力します。その数の基準となるしきい値は RealmJoin Tenant の設定です（既定は 90 日）。そのため、この数は通常、ここで同期されているデバイス数より大きくなります。逆方向に大きく差がある場合は、同期ウィンドウまたは許容ギャップが Tenant に対して厳しすぎることを意味します。

### RealmJoin API 資格情報の設定

runbook は RealmJoin customer API を照会し、Azure Automation Account に保存された専用の資格情報が必要です。同じ資格情報は API を使用するすべての runbook で使われるため、Automation Account ごとに 1 回だけ設定すれば十分です。

1. **API 資格情報を取得する** - まだ RealmJoin API の資格情報をお持ちでない場合は、<support@realmjoin.com> へ依頼してください。ユーザー名は `t-<tenant id>`の形式で、パスワードは API シークレットです。ポータルへのログインはここでは使えません。
2. **デバイスユーザー機能を依頼する** - customer API のデバイス一覧は、RealmJoin がテナントごとに有効化する機能です。資格情報と一緒にサポートへ有効化を依頼してください。これがないと API は HTTP 403 を返し、runbook はそのメッセージで停止します。
3. **Automation Account を開く** - Azure Portal で、runbook に使用する Automation Account を開きます。
4. **Shared Resources > Credentials に移動する** - 左側メニューの *Shared Resources*で、 *Credentials*.
5. **新しい資格情報を追加する** - *資格情報を追加*.
6. **名前は正確に `RJAPI`** - runbook はこの名前を検索します。ほかの名前では資格情報の検索に失敗します。
7. **API のユーザー名とシークレットを入力する** - 手順 1 の値を使用します。
8. **保存** - *作成* そして runbook をもう一度実行します。

API は Tenant ごとに 1 分あたり 30 リクエストまで許可し、それを超えると HTTP 429 を返します。runbook は 1 回の実行で 2 リクエスト必要とし、スロットリングされたリクエストは少し待ってから最大 5 回まで再試行し、それでもだめなら諦めます。

### レポートの配信

結果は常に、RealmJoin portal の Output Data タブに名前付きテーブルとして表示されます。レポート ファイルが生成されるのは、 **レポートの配信** オプションにメールおよび/またはダウンロードリンクが含まれている場合にのみ *出力データのみ* レポート ファイルは作成されません。メール配信とダウンロードリンクの生成は独立しており、組み合わせることができます。

ダウンロードリンクの場合、レポート ファイルは、Azure Storage Account に構成された `RJReport.StorageAccount.*` テナント設定にアップロードされ、期限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは、Automation アカウントのマネージド ID で認証されます。その ID には **Reader and Data Access** 対象の Storage Account に対する RBAC ロールが必要です（これは Azure RBAC の割り当てであり、Graph のアプリケーション権限ではありません）。

### メール送信に関する設定

メール レポートの送信は任意であり、 *レポートもメール送信* または *レポートもメール送信とダウンロードリンク* がレポート配信として選択されます。その場合、受信者が必要です。送信者アドレスは次から取得されます。 `RJReport.EmailSender` テナント設定から取得されます。

この runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、runbook のカスタマイズで既存のメール アドレスを構成する必要があります。

詳細については、 [RealmJoin Report Settings のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) を参照してください。

#### メールのブランド設定

レポート メールでは、任意の `RJReport.Branding.*` テナント設定:

* **ヘッダーとフッターの画像** - 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
* **フッター リンク** - フッター画像のターゲット
* **アクセント色とテキスト色** - 6 桁の 16 進値、例: `#0052cc`

これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像や、無効な色値があっても、レポートメールが送信されなくなることはありません。代わりに対応する既定値が使用されます。

設定手順と画像要件: [メールのブランド設定](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### スケジューリング

レポートは毎週実行してください。許容ギャップは既定の 14 日、同期ウィンドウは 30 日から始めます。リストがきれいになったらギャップを短くし、長いアイドル期間のデバイスが引き続き表示される場合はギャップを大きくします。

両方の値を固定し、レポートをメールで配信するカスタマイズ例：

```json
"rjgit-org_devices_report-realmjoin-agent-contact_scheduled": {
    "parameters": {
        "SyncThresholdDays": {
            "Default": 30
        },
        "AgentContactThresholdDays": {
            "Default": 14
        },
        "EmailTo": {
            "Default": "endpoint-team@contoso.com"
        }
    }
}
```

詳細については、 [Runbook カスタマイズ ガイド](https://docs.realmjoin.com/automation/runbooks/runbook-customization) 構文について。

### 注意事項と制限

* 比較対象は Windows デバイスのみです。RealmJoin エージェントは Windows 上で動作するためです。
* RealmJoin の customer API では、エージェントのバージョンもデバイスごとの Intune 同期時刻も公開されません。比較は上で説明したエージェント接触に基づいています。
* 表に表示される Intune のプライマリ ユーザーは、Intune に記録されているユーザーであり、必ずしもエージェントが最後に見たユーザーではありません。両方とも次の `AgentStale` 行です。

### 場所

Organization → Devices → Report RealmJoin Agent Contact (Scheduled)

**完全な Runbook 名**

rjgit-org\_devices\_report-realmjoin-agent-contact\_scheduled

### 詳細

| プロパティ    | 値                                                                                                                  |
| -------- | ------------------------------------------------------------------------------------------------------------------ |
| バージョン    | 1.1.0                                                                                                              |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| スケジュール可能 | はい                                                                                                                 |

### アクセス許可

#### アプリケーションのアクセス許可

* **型**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *比較のために、Intune 内の Windows デバイスとそれぞれのプライマリ ユーザーおよび最終同期時刻を読み取ります*
  * GroupMember.Read.All
    * *対象範囲を絞り込む任意の include グループと exclude グループのデバイス メンバーを読み取ります*
  * Mail.Send *（任意 — 機能: メール レポート）*
    * *メール配信が選択されている場合、Send-RjRbReportEmail を介してレポートメールを送信します*
  * Organization.Read.All *（任意 — 機能: メール レポート）*
    * *メールの件名、メール本文、レポート ファイル名のために Tenant の表示名を読み取ります*

#### 権限に関する注意事項

RealmJoin customer API: RealmJoin サポートが発行したテナントの API ユーザー名（t-）とシークレットを使った、Azure Automation Account の 'RJAPI' という名前の資格情報が必要です RealmJoin customer API: この API の device users 機能は、RealmJoin サポートによってテナントで有効化されている必要があります（そうでない場合、device list は HTTP 403 を返します） Azure Storage Account: 対象の Storage Account にある Automation Account のマネージド ID には 'Reader and Data Access' ロールが必要です - アップロードでは listKeys を使ってアカウント キーを取得します（ダウンロード リンク オプションでのみ必要）

### パラメーター

#### SyncThresholdDays

Intune とこの日数以内に同期したデバイスのみが比較されます。まったく同期しなくなったデバイスは、代わりに古いデバイスのレポートに含まれます。

| プロパティ    | 値                    |
| -------- | -------------------- |
| 必須       | false                |
| 既定値      | 30                   |
| 型        | Int32                |
| ポータルの表示名 | Intune の最終同期から（日数）以内 |

#### AgentContactThresholdDays

Intune が RealmJoin の最終確認から少なくともこの日数後にそのデバイスを確認した場合、そのデバイスは agent stale と見なされます。エージェントはユーザーがサインインしている間しか報告しないため、短いギャップは正常です。

| プロパティ    | 値                              |
| -------- | ------------------------------ |
| 必須       | false                          |
| 既定値      | 14                             |
| 型        | Int32                          |
| ポータルの表示名 | RealmJoin の最終確認から許容されるギャップ（日数） |

#### DeviceNamePrefix

名前がこの文字列で始まるデバイスのみ。すべて対象にするには空欄のままにします。

| プロパティ    | 値             |
| -------- | ------------- |
| 必須       | false         |
| 既定値      |               |
| 型        | 文字列           |
| ポータルの表示名 | デバイス名のプレフィックス |

#### IncludeAgentStale

Intune が RealmJoin の最終確認よりかなり後に確認したデバイスを一覧表示します。これは、もはや報告しないエージェントの兆候です。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | True                     |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### IncludeNeverSeen

RealmJoin が認識しているが、サインイン済みユーザーを一度も見たことのないデバイスを一覧表示します。たとえば、登録済みだがまだ使われていないデバイスです。

| プロパティ    | 値                                |
| -------- | -------------------------------- |
| 必須       | false                            |
| 既定値      | True                             |
| 型        | ブール値                             |
| ポータルの表示名 | RealmJoin が一度も見たことのないデバイスを含めますか? |

**ポータル オプション**

| ポータル オプション | 値     |
| ---------- | ----- |
| はい         | true  |
| なし         | false |

#### IncludeMissingInRealmJoin

Intune には存在するが RealmJoin には存在しないデバイスを一覧表示します。

| プロパティ    | 値                           |
| -------- | --------------------------- |
| 必須       | false                       |
| 既定値      | False                       |
| 型        | ブール値                        |
| ポータルの表示名 | RealmJoin に存在しないデバイスを含めますか？ |

**ポータル オプション**

| ポータル オプション | 値     |
| ---------- | ----- |
| はい         | true  |
| なし         | false |

#### IncludeMissingInIntune

RealmJoin には存在するが、同期ウィンドウ内に Intune と同期しなかったデバイスを一覧表示します。デバイス名プレフィックスとは併用できません。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルの表示名 | Intune に存在しないデバイスを含めますか？ |

**ポータル オプション**

| ポータル オプション | 値     |
| ---------- | ----- |
| はい         | true  |
| なし         | false |

#### IncludeDeviceGroup

この Entra ID グループ内のデバイスのみ。すべてのデバイスを対象にするには空欄のままにします。

| プロパティ    | 値             |
| -------- | ------------- |
| 必須       | false         |
| 既定値      |               |
| 型        | 文字列           |
| ポータルの表示名 | グループのデバイスを含める |

#### ExcludeDeviceGroup

この Entra ID グループ内のデバイスをスキップします。たとえば、サインインユーザーがほとんどいないキオスクや共有デバイスです。何もスキップしない場合は空欄にします。

| プロパティ    | 値             |
| -------- | ------------- |
| 必須       | false         |
| 既定値      |               |
| 型        | 文字列           |
| ポータルの表示名 | グループからデバイスを除外 |

#### EmailFrom

レポート メールの送信者アドレス。テナント設定 RJReport.EmailSender から取得されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingHeaderImageUrl

レポート メールのヘッダー画像（HTTPS URL、PNG/JPEG/GIF、最大 200 KB）。テナント設定 RJReport.Branding.HeaderImageUrl から取得されます。空の場合は既定の RealmJoin のヘッダーが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingFooterImageUrl

レポート メールのフッター画像（HTTPS URL、PNG/JPEG/GIF、最大 200 KB）。テナント設定 RJReport.Branding.FooterImageUrl から取得されます。空の場合は既定の RealmJoin のフッターが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingFooterLink

レポート メールのフッター画像の背後にあるリンク先。テナント設定 RJReport.Branding.FooterLink から取得されます。空の場合は realmjoin.com が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingAccentColor

レポート メールのアクセント色を 6 桁の 16 進値で指定します。テナント設定 RJReport.Branding.AccentColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingTextColor

レポート メールのテキスト色を 6 桁の 16 進値で指定します。テナント設定 RJReport.Branding.TextColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### SendEmailReport

レポートを受信者のメールアドレスに送信します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### EmailTo

レポートをこれらのアドレスに送信します。複数ある場合はカンマで区切ってください。各受信者には個別のメールが送信されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルの表示名 | 受信者のメール アドレス             |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ReportFileFormat

レポートを CSV、Excel ブック、またはその両方で配信します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | CSV と XLSX               |
| 型        | 文字列                      |
| ポータルの表示名 | レポート ファイル形式              |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

**ポータル オプション**

| ポータル オプション | 値          |
| ---------- | ---------- |
| CSV と XLSX | CSV と XLSX |
| CSV のみ     | CSV のみ     |
| XLSX のみ    | XLSX のみ    |

#### CreateDownloadLink

レポートもアップロードし、数日後に期限切れになるダウンロード リンクを返します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ContainerName

レポート ファイルをアップロードする Storage container。runbook ごとに設定します。

| プロパティ    | 値                              |
| -------- | ------------------------------ |
| 必須       | false                          |
| 既定値      | report-realmjoin-agent-contact |
| 型        | 文字列                            |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定）       |

#### ResourceGroupName

レポート アップロード用の Storage Account のリソース グループ。テナント設定 RJReport.StorageAccount.ResourceGroup から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### StorageAccountName

レポート アップロード用の Storage Account。テナント設定 RJReport.StorageAccount.StorageAccountName から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### SubscriptionId

レポート アップロード用の Storage Account のサブスクリプション ID。テナント設定 RJReport.StorageAccount.SubscriptionId から取得します。空の場合は、管理対象 ID がサインインするサブスクリプションが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### LinkExpiryDays

ダウンロード リンクの有効期間（日数）。テナント設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | 6                        |
| 型        | Int32                    |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

[Runbook リファレンスの概要に戻る](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/devices/report-realmjoin-agent-contact_scheduled.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
