> 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 です。単一のオブジェクトに対してトリガーされるのではなく、繰り返しのスケジュールで実行されるように設計されています。詳細は [スケジューリング](/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールの設定方法の詳細については
{% endhint %}

### 説明

選択したプラットフォームのすべての Intune デバイスの主要ユーザーを収集し、Entra ID グループをそれらと同期します。一致するデバイスがないユーザーは、削除をオフにしない限り削除されます。含めるグループは対象ユーザーを制限し、除外グループはユーザーをブロックします。report-only モードでは、何も適用せずに変更をメールでプレビューします。

### 一般的な使用例

* 配布グループまたは Conditional Access の対象グループを、「現在管理対象デバイスを持っているユーザー」と一致するように、プラットフォーム、詳細な OData フィルター、または含める/除外するグループのスコープで絞り込みながら維持します。
* 新しい、または変更されたフィルターやスコープが、本番グループへの書き込みを許可される前に検証します。

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

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

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

### 場所

組織 → 全般 → デバイスの主要ユーザーをグループに追加 (スケジュール済み)

**完全な 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
    * *対象/含める/除外するグループを検証し、それらのメンバー一覧を読み取ります*
  * 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

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

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

#### ReportFileFormat

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

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

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

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

[Runbook リファレンスの概要に戻る](/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.