> 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/general/add-primary-users-of-devices-to-group_scheduled.md).

# デバイスのプライマリ ユーザーをグループに追加（スケジュール済み）

グループを Intune デバイスのプライマリ ユーザーと同期させる

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

### 説明

選択したプラットフォームのすべての Intune デバイスの主要ユーザーを収集し、それらと Entra ID グループを同期状態に保ちます。対応するデバイスがないユーザーは、削除が無効になっていない限り削除されます。include グループは対象となるユーザーを制限し、exclude グループはユーザーをブロックします。レポートのみモードでは、何も適用せずに、変更内容のプレビューをメールで表示します。

### 一般的な使用例

* 配布グループまたは Conditional Access の対象グループを、「現在マネージド デバイスを持っているユーザー」に合わせて維持します。対象はプラットフォーム、詳細な OData フィルター、または include/exclude グループのスコープで絞り込まれます。
* 新しい、または変更されたフィルターやスコープが、本番グループへの書き込みを許可される前に検証されます。

毎日実行のスケジュールを推奨します。

### パイロット運用とテスト用のレポートのみモード

有効化 `ReportOnly` 実際の実行が生成するのと同じ追加/削除の差分を、グループにいかなる変更も適用せずに計算するために使用します。代わりに、影響を受けるユーザーを UPN で一覧表示した Markdown のプレビュー メールが送信先に送信されます `EmailTo`: 各リスト（追加予定、削除予定）は、メール本文には最大 10 人のユーザーを表示し、リストがそれより長い場合は「... and N more」の注記が付き、完全なリストは、選択した形式のレポート ファイルとして添付されます `ReportFileFormat`。プラットフォームの選択を変更した後、このモードで 1 回実行し、 `AdvancedFilter` または include/exclude グループを変更した場合は、プレビューを確認してから、無効にし `ReportOnly` て同期を適用します。

### パラメーターの相互作用

* `AdvancedFilter`設定されている場合、Windows/macOS/iOS/Android のプラットフォーム選択と組み合わせるのではなく、それを完全に置き換えます。
* `RemoveUsersWhenNoDeviceMatch` 実運用の実行と `ReportOnly` プレビュー: 無効にすると、どちらの場合もユーザーは削除されないため、プレビューは常に実際の実行で行われる内容を反映します。

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

メール レポートの送信はオプションであり、 `ReportOnly` オプションが有効な場合、受信者（`EmailTo`）が必要になります。送信者アドレスは次から取得されます `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).

### 場所

Organization → General → Add Primary Users Of Devices To Group (Scheduled)

**完全な Runbook 名**

rjgit-org\_general\_add-primary-users-of-devices-to-group\_scheduled

### 詳細

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

### アクセス許可

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

* **型**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *OS でフィルターされた Intune 管理対象デバイスを読み取り、各デバイスの主要ユーザーを収集します*
  * Group.Read.All
    * *対象/ include/ exclude グループを検証し、それぞれのメンバー一覧を読み取ります*
  * GroupMember.ReadWrite.All
    * *バッチ化された /groups/{id}/members/$ref 呼び出しを使用して、ターゲット グループ内でユーザーを追加および削除します*
  * User.Read.All
    * *メンバー ID と UPN を読み取り、ユーザーメンバーを識別して削除をログに記録します*

### パラメーター

#### TargetGroupId

主要ユーザーを受け取るグループです。メンバーシップはこの runbook のみで管理されます。

| プロパティ    | 値          |
| -------- | ---------- |
| 必須       | true       |
| 既定値      |            |
| 型        | 文字列        |
| ポータルの表示名 | ターゲット グループ |

#### Windows

Windows デバイスの主要ユーザーを含めます。

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

#### macOS

macOS デバイスの主要ユーザーを含めます。

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

#### iOS

iOS および iPadOS デバイスの主要ユーザーを含めます。

| プロパティ    | 値               |
| -------- | --------------- |
| 必須       | false           |
| 既定値      | False           |
| 型        | ブール値            |
| ポータルの表示名 | iOS デバイスを含めますか? |

#### Android

Android デバイスの主要ユーザーを含めます。

| プロパティ    | 値                   |
| -------- | ------------------- |
| 必須       | false               |
| 既定値      | False               |
| 型        | ブール値                |
| ポータルの表示名 | Android デバイスを含めますか? |

#### AdvancedFilter

プラットフォームの切り替えの代わりに使用するデバイスの OData フィルター。たとえば startsWith(deviceName,'FWP-') and operatingSystem eq 'Windows' です。

| プロパティ    | 値          |
| -------- | ---------- |
| 必須       | false      |
| 既定値      |            |
| 型        | 文字列        |
| ポータルの表示名 | カスタム フィルター |

#### RemoveUsersWhenNoDeviceMatch

ターゲット グループのメンバーでなくなったユーザーを削除します。追加だけにするには無効にします。

| プロパティ    | 値                       |
| -------- | ----------------------- |
| 必須       | false                   |
| 既定値      | True                    |
| 型        | ブール値                    |
| ポータルの表示名 | 一致するデバイスのないユーザーを削除しますか？ |

#### IncludeGroupId

このグループのメンバーのみをターゲット グループに追加できます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルの表示名 | グループからユーザーを含める           |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ExcludeGroupId

このグループのメンバーは追加されず、存在する場合は削除されます。

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

#### ReportOnly

変更を適用せずにプレビューします。プレビューはメールで送信され、本文には各リストの最初の 10 人のユーザーが表示され、完全なリストが添付されます。

| プロパティ    | 値          |
| -------- | ---------- |
| 必須       | false      |
| 既定値      | 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 のカスタマイズで事前設定） |

#### EmailTo

プレビューの送信先です。レポートのみモードでのみ使用されます。

| プロパティ    | 値             |
| -------- | ------------- |
| 必須       | false         |
| 既定値      |               |
| 型        | 文字列           |
| ポータルの表示名 | プレビュー レポートを送信 |

#### ReportFileFormat

完全なリストを CSV、Excel ブック、またはその両方として添付します。レポートのみモードでのみ使用されます。

| プロパティ    | 値                 |
| -------- | ----------------- |
| 必須       | false             |
| 既定値      | CSV と XLSX        |
| 型        | 文字列               |
| ポータルの表示名 | プレビュー レポートのファイル形式 |

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

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

[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/general/add-primary-users-of-devices-to-group_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.
