> 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-primary-user-mismatch_scheduled.md).

# プライマリ ユーザー不一致のレポート - 定期実行

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

### 説明

Windows 管理対象デバイスの場合、このスケジュール済みレポートは Intune に記録されたプライマリ ユーザーを RealmJoin customer API に記録されたプライマリ ユーザーと比較します。各デバイスごとに 2 つのデータセットを相関付け、プライマリ ユーザーが異なるデバイスにフラグを付け、CSV および/または Excel (xlsx) の添付ファイルとして差異をメール送信します。レポート ファイルは Azure Storage Account にアップロードすることもでき、期間限定のダウンロード リンクが返されます。ReportFileFormat パラメーターは、生成して配信するファイル形式（CSV のみ、CSV & XLSX、または XLSX のみ）を制御します。CSV 添付ファイルがメールのサイズ上限を超え、"CSV & XLSX" が選択されている場合、メールは Excel ブックのみへフォールバックします。

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

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

この手順については、 [RealmJoin レポート設定のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings).

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

レポートメールでは、任意の `RJReport.Branding.*` テナント設定が考慮されます。対象は、カスタムのヘッダー画像、カスタムのフッター画像（公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB）、カスタムのフッターリンク、およびカスタムのアクセントカラーとテキストカラー（6 桁の hex 値、例: `#0052cc`）です。これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できないブランド画像、または有効な hex カラーではない色の値があっても、レポートメールが送信されなくなることはありません。代わりに、該当する既定値が使用されます。

詳細については、 [RealmJoin レポート設定のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) 設定の詳細については、

### RealmJoin API 資格情報のセットアップ

この runbook は RealmJoin customer API をクエリし、Azure Automation Account に保存された専用の資格情報を必要とします。

**手順ごとのセットアップ:**

1. **API 資格情報を取得** — まだ RealmJoin API 資格情報をお持ちでない場合は、<support@realmjoin.com> まで依頼してください
2. **Automation Account を開く** — Azure Portal で、runbook に使用する Automation Account に移動します
3. **Shared Resources > Credentials に移動する** — 左側メニューの *共有リソース*で、 *資格情報*
4. **新しい資格情報を追加** — *資格情報を追加*
5. **名前は次のとおり正確に設定します `RJAPI`** — runbook はこの名前を参照します。少しでも異なると資格情報の検索に失敗します
6. **RealmJoin API のユーザー名とパスワードを入力します** — 手順 1 の資格情報を使用します
7. **保存** — *作成* して runbook を再実行します

### 場所

Organization → Devices → プライマリ ユーザー不一致をレポート (スケジュール済み)

**Runbook の完全名**

rjgit-org\_devices\_report-primary-user-mismatch\_scheduled

### 詳細

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

### 注意

前提条件:

* 正確に "RJAPI" という名前の Azure Automation Account 共有資格情報は、スケジュール設定の前に手動で作成する必要があります。ユーザー名とパスワードは RealmJoin customer API アカウントに一致させてください (<https://docs.realmjoin.com/dev-reference/realmjoin-api/authentication> を参照)。
* Automation Account のマネージド ID には、次の Graph アプリケーション権限が割り当てられている必要があります: DeviceManagementManagedDevices.Read.All, Mail.Send, Organization.Read.All.
* RJReport.EmailSender 設定は、最初の実行前に有効な送信者アドレスで構成する必要があります。
* 2 つのデータセットが同期している場合、メールは送信されません。空の実行はエラーではありません。

### アクセス許可

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

* **種類**：Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *各 Windows デバイスのプライマリ ユーザーを比較用に取得するため、Intune 管理対象デバイスを読み取ります*
  * Directory.Read.All
    * *グループ メンバーを読み取り、任意の include/exclude デバイス グループ スコープ フィルターを解決します*
  * Mail.Send *（任意 — 機能: メールレポート）*
    * *構成済みの EmailTo 宛先に Send-RjReportEmail を使用して不一致レポートを送信します*
  * Organization.Read.All
    * *レポートに表示される Tenant 名のために /organization を読み取ります*

### パラメーター

#### SyncThresholdDays

Intune の最終同期フィルターをさかのぼって検索する日数です。ここで指定した日数内に同期した Windows デバイスのみが評価されます。

| プロパティ   | 値               |
| ------- | --------------- |
| 必須      | いいえ             |
| 既定値     | 30              |
| 種類      | Int32           |
| ポータル表示名 | Intune 最終同期（日数） |

#### DeviceNamePrefix

レポートを特定のデバイスのサブセットに絞り込むための、任意のデバイス名プレフィックスです。すべてのデバイスを含めるには空欄のままにします。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | いいえ              |
| 既定値     |                  |
| 種類      | 文字列              |
| ポータル表示名 | デバイス名プレフィックス（任意） |

#### IncludeMismatches

Intune と RealmJoin でプライマリ ユーザーが異なるデバイスをレポートに含めます。既定で有効です。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      | はい                       |
| 種類       | ブール値                     |
| ポータル表示名  | 不一致を含める                  |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### IncludeMissingInRealmJoin

Intune には存在するが RealmJoin には対応するデバイスがないデバイスをレポートに含めます。既定で無効です。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      | False                    |
| 種類       | ブール値                     |
| ポータル表示名  | RealmJoin に存在しないものを含める   |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### IncludeMissingInIntune

RealmJoin には存在するが Intune には対応するデバイスがないデバイスをレポートに含めます。既定で無効です。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      | False                    |
| 種類       | ブール値                     |
| ポータル表示名  | Intune に存在しないものを含める      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### IncludePrimaryUserDeleted

Entra ID から削除された Intune のプライマリ ユーザーを持つデバイスをレポートに含めます。Intune は、削除されたユーザーの user principal name の先頭に object id を付与して変更するため、そうしないと誤った不一致として表示される可能性があります。既定で有効です。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      | False                    |
| 種類       | ブール値                     |
| ポータル表示名  | 削除されたプライマリ ユーザーを含める      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### UseDeviceScope

Entra デバイス グループのメンバーシップに基づいてデバイスを含めるか除外するスコープ フィルタリングを有効にします。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      | False                    |
| 種類       | ブール値                     |
| ポータル表示名  | デバイス スコープ フィルタリングを使用     |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### IncludeDeviceGroup

この Entra デバイス グループのメンバーであるデバイスのみをレポートに含めます。デバイス スコープ フィルタリングを有効にする必要があります。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータル表示名  | 含めるデバイス（グループ）            |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### ExcludeDeviceGroup

この Entra デバイス グループのメンバーであるデバイスをレポートから除外します。デバイス スコープ フィルタリングを有効にする必要があります。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータル表示名  | 除外するデバイス（グループ）           |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### EmailTo

指定した場合、レポート付きのメールが指定されたアドレス宛てに送信されます。単一のアドレスでも、カンマ区切りの複数アドレスでも指定できます。

| プロパティ   | 値        |
| ------- | -------- |
| 必須      | いいえ      |
| 既定値     |          |
| 種類      | 文字列      |
| ポータル表示名 | レポートの送信先 |

#### EmailFrom

送信者のメールアドレス。これは runbook のカスタマイズ設定で構成され、portal では非表示です。

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

#### BrandingHeaderImageUrl

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

#### BrandingFooterImageUrl

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

#### BrandingFooterLink

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

#### BrandingAccentColor

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

#### BrandingTextColor

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

#### ReportFileFormat

生成および配信されるレポート ファイル形式を制御します: CSV のみ、CSV と XLSX（既定）または XLSX のみ。

| プロパティ   | 値           |
| ------- | ----------- |
| 必須      | いいえ         |
| 既定値     | CSV と XLSX  |
| 種類      | 文字列         |
| ポータル表示名 | レポート ファイル形式 |

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

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

#### CreateDownloadLink

有効にすると、レポート ファイルは Azure Storage Account にアップロードされ、期限付きのダウンロード リンクが返されます。既定では無効です。

| プロパティ   | 値                                          |
| ------- | ------------------------------------------ |
| 必須      | いいえ                                        |
| 既定値     | False                                      |
| 種類      | ブール値                                       |
| ポータル表示名 | ファイルのダウンロード リンクを作成しますか（レポートをストレージにアップロード）? |

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

| ポータルオプション                       | 値   |
| ------------------------------- | --- |
| はい - レポートをアップロードしてダウンロード リンクを返す | はい  |
| いいえ - ダウンロード リンクを作成しない          | いいえ |

#### ContainerName

アップロードに使用するストレージ コンテナー名。runbook ごとに設定されます（グローバルな RJReport 設定ではありません）。

| プロパティ    | 値                            |
| -------- | ---------------------------- |
| 必須       | いいえ                          |
| 既定値      | report-primary-user-mismatch |
| 種類       | 文字列                          |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定）     |

#### ResourceGroupName

Storage Account を含むリソース グループ。RJReport の Tenant 設定から取得されます。

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

#### StorageAccountName

アップロードに使用する Storage Account 名。RJReport の Tenant 設定から取得されます。

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

#### LinkExpiryDays

生成されたダウンロードリンクの有効期限が切れるまでの日数。RJReport の Tenant 設定から取得されます。

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

[Runbook Reference の概要に戻る](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.