> 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/security/sync-mfa-secure-users-to-group_scheduled.md).

# MFA 保護ユーザーをグループに同期 - 定期実行

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

### 説明

この runbook は、Entra ID の認証方法登録レポートに基づき、少なくとも 1 つの「安全な」認証方法が登録されているすべてのメンバー ユーザーと Entra ID グループを同期します。どの方法グループを安全とみなすかはトグルで構成できます（Passkeys/FIDO2、プラットフォーム資格情報、Microsoft Authenticator アプリ、ソフトウェア OTP、ハードウェア OTP、証明書ベースの認証）。安全な方法が登録されていないユーザーはグループから削除されます。任意の厳格モード（"SecureOnly"）では、ユーザーが安全な方法に加えて安全でない方法（電話、メール、セキュリティの質問）を 1 つでも登録している場合は、さらに対象外になります。管理者ユーザー（アクティブまたは PIM 対象の Entra ID ディレクトリ ロール保持者。ロール割り当て可能グループのメンバーを含む）は既定で除外されます（"ExcludeAdmins"）- これは、対象グループが SSPR の基盤になっている場合に便利です。その場合、管理者はそうでなければ第 2 要素の登録を強制されるためです。任意の除外グループを使うと、break glass や service アカウントのようなアカウントを対象グループから恒久的に除外できます。個々のユーザーは、マルチユーザー ピッカー（"ExcludeUserIds"）で直接除外することもできます。除外されたユーザーは追加されることはなく、すでにメンバーであれば削除されます。ゲスト ユーザーとユーザーではないグループ メンバーは影響を受けません。

任意で、詳細レポートをメールで送信したり、Azure Storage Account にアップロードしたりできます（期限付きダウンロード リンクを返します）。レポートには、CSV ファイルと、情報表紙シート（選択したパラメーターと結果件数）、実行された変更、およびすべてのメンバー ユーザーに対するユーザー別評価を含む書式設定済み Excel ブックが含まれます。レポート ファイルは、メールまたはダウンロード リンクが有効な場合にのみ生成されます。

### 仕組み

runbook は Entra ID の [認証方法登録レポート](https://learn.microsoft.com/en-us/graph/api/authenticationmethodsroot-list-userregistrationdetails) (`userRegistrationDetails`）を読み取り、対象グループをすべての **メンバー ユーザー** のうち、該当するものに対してミラー同期します：

* ユーザーは、登録済みの方法の少なくとも 1 つが、構成済みの **安全な** セットに含まれている場合に該当します。
* 「 **厳格モード** (`SecureOnly`」では、ユーザーはさらに次のいずれの方法も **安全でない** セットとして登録していてはなりません。たとえば、パスキー ユーザーでも SMS 要素を併用している場合は該当しません。
* まだグループ メンバーでない該当ユーザーは追加され、もはや該当しないメンバーは削除されます（ミラー同期）。
* ゲスト ユーザーは追加も削除もされません。ユーザーではないグループ メンバー（デバイス、Service Principals、ネストされたグループ）も影響を受けません。

対象グループは、この runbook のみによって管理されるべきです。

### 安全な方法グループ

各トグルは、どの `methodsRegistered` の値を安全とみなすかを制御します：

| トグル                           | 既定 | 対象の値                                                                                 |
| ----------------------------- | -- | ------------------------------------------------------------------------------------ |
| Passkeys / FIDO2 Security Key | 有効 | `fido2SecurityKey`, `passKeyDeviceBound`, `passKeyDeviceBoundAuthenticator`          |
| プラットフォーム資格情報                  | 有効 | `windowsHelloForBusiness`, `passKeyDeviceBoundWindowsHello`, `macOsSecureEnclaveKey` |
| Microsoft Authenticator アプリ   | 有効 | `microsoftAuthenticatorPush`, `microsoftAuthenticatorPasswordless`                   |
| ソフトウェア OTP                    | 無効 | `softwareOneTimePasscode`                                                            |
| ハードウェア OTP                    | 無効 | `hardwareOneTimePasscode`                                                            |
| 証明書ベースの認証                     | 有効 | `certificateBasedAuthentication`                                                     |

### 厳格モード（SecureOnly）

厳格モードを有効にすると、次の組み込みの安全でない方法のいずれかを持つユーザーは、該当しません：

`mobilePhone`, `alternateMobilePhone`, `officePhone`, `email`, `securityQuestion`

ある方法が安全なセットと安全でないセットの両方に含まれる場合（オーバーライド パラメーターでのみ発生します）、安全でない方が優先されます。したがって、そのようなユーザーは厳格モードでは決して該当しません。runbook は起動時にこれを警告します。

### 除外

除外されたユーザーは、登録済みの方法にかかわらず該当しません。対象グループには追加されず、すでにメンバーの場合は削除されます。ユーザー別レポートでは、その理由が `ExclusionReason` 列に表示されます。

#### 管理者ユーザーを除外（`ExcludeAdmins`、既定で有効）

Entra ID ディレクトリ ロールを保持するユーザーは除外されます。対象は次のとおりです：

* **アクティブなロール割り当て** (`roleManagement/directory/roleAssignments`)
* **PIM 対象の割り当て** (`roleManagement/directory/roleEligibilitySchedules`、Entra ID P2 が必要です。P2 がない場合、runbook はアクティブな割り当てにフォールバックし、警告を記録します）
* **ロール割り当て可能グループ**：ロールを保持するグループは、その推移的なユーザー メンバーまで展開されます

背景：対象グループが **SSPR** で、SSPR 管理者ポリシーが無効でも、2 つの SSPR 方法が必要になると、グループ内の管理者は引き続き第 2 要素の登録を強制されます。管理者をグループから外しておけば、これを回避できます。

このオプションには、追加の Graph 権限 `RoleManagement.Read.Directory` が managed identity に必要です。

#### 除外グループ（`ExcludeGroupId`、任意）

構成されたグループの推移的なユーザー メンバーが除外されます。これは、この同期で決して管理されるべきではないアカウント向けです。たとえば **break glass アカウント** または **service アカウント**などです。ネストされたグループも考慮されます。除外グループは対象グループ自身であってはなりません。

#### 個別に除外されたユーザー（`ExcludeUserIds`、任意）

個々のユーザーは、専用の除外グループを維持するほどではない一回限りの除外のために、マルチユーザー ピッカーから直接除外できます。リストにはユーザー **オブジェクト ID** と **ユーザー プリンシパル名** （UPN）を指定できます。解決できない項目（削除済みアカウントなど）は警告を記録して無視されるため、古い項目が原因でスケジュールされた同期が壊れることはありません。

#### Runbook Customization を使った除外の管理（ピッカーを使わない方法）

両方の除外パラメーターは、次を介して中央で事前設定できます： [JSON ベースの Runbook Customization](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) （RealmJoin ポータル： **設定** → **Runbook Customizations**）— 除外が tenant に固定されており、runbook を開始またはスケジュールするたびに手動で選ぶべきではない場合に便利です：

```json
{
    "Runbooks": {
        "rjgit-org_security_sync-mfa-secure-users-to-group_scheduled": {
            "Parameters": {
                "ExcludeGroupId": {
                    "DefaultValue": "00000000-0000-0000-0000-000000000000",
                    "Hide": true
                },
                "ExcludeUserIds": {
                    "DefaultValue": [
                        "11111111-1111-1111-1111-111111111111",
                        "breakglass@contoso.com"
                    ],
                    "Hide": true
                }
            }
        }
    }
}
```

* **ExcludeGroupId** 1 つのグループ **オブジェクト ID** （GUID）をプレーン文字列として受け取ります。Entra admin center または RealmJoin ポータルのグループ概要ページからコピーしてください。
* **ExcludeUserIds** JSON **文字列の配列**を受け取ります。各項目はユーザー **オブジェクト ID** または **UPN**を指定できます。項目は前後の空白が削除され、重複は除去されます。runbook は起動時にそれらを解決します。
* **推奨：** 除外を Runbook Customization で管理する場合は、同時に `"Hide": true` をパラメーターで有効にしてください（上の例のとおり）。これにより開始フォームから完全に削除されるため、中央で構成された除外が runbook の開始やスケジュール時に UI で上書きされることがなくなります。 `非表示`がないと、構成済みの値はプレフィルされた状態で表示されるだけで、そこで変更することもできます。

### 方法分類リファレンス

カンマ区切りのオーバーライド文字列を作成する際は、この表の正確な Graph 値を使用してください：

| `methodsRegistered` 値                | 表示名                                      | 分類    | トグルで制御（既定）                      |
| ------------------------------------ | ---------------------------------------- | ----- | ------------------------------- |
| `fido2SecurityKey`                   | FIDO2 Security Key                       | 安全    | Passkeys / FIDO2（有効）            |
| `passKeyDeviceBound`                 | デバイス固定パスキー                               | 安全    | Passkeys / FIDO2（有効）            |
| `passKeyDeviceBoundAuthenticator`    | Microsoft Authenticator のパスキー            | 安全    | Passkeys / FIDO2（有効）            |
| `windowsHelloForBusiness`            | Windows Hello for Business               | 安全    | プラットフォーム資格情報（有効）                |
| `passKeyDeviceBoundWindowsHello`     | Windows Hello のパスキー                      | 安全    | プラットフォーム資格情報（有効）                |
| `macOsSecureEnclaveKey`              | macOS のプラットフォーム資格情報                      | 安全    | プラットフォーム資格情報（有効）                |
| `microsoftAuthenticatorPush`         | Microsoft Authenticator（プッシュ通知）          | 安全    | Microsoft Authenticator アプリ（有効） |
| `microsoftAuthenticatorPasswordless` | Microsoft Authenticator（パスワードレスの電話サインイン） | 安全    | Microsoft Authenticator アプリ（有効） |
| `softwareOneTimePasscode`            | ソフトウェア OATH トークン（TOTP アプリ）               | 安全    | ソフトウェア OTP（無効）                  |
| `hardwareOneTimePasscode`            | ハードウェア OATH トークン                         | 安全    | ハードウェア OTP（無効）                  |
| `certificateBasedAuthentication`     | 証明書ベースの認証                                | 安全    | 証明書ベースの認証（有効）                   |
| `mobilePhone`                        | 電話（SMS / 音声通話）                           | 安全でない | 組み込みの安全でない一覧                    |
| `alternateMobilePhone`               | 代替電話（音声通話）                               | 安全でない | 組み込みの安全でない一覧                    |
| `officePhone`                        | オフィス電話（音声通話）                             | 安全でない | 組み込みの安全でない一覧                    |
| `email`                              | メール（SSPR のみ）                             | 安全でない | 組み込みの安全でない一覧                    |
| `securityQuestion`                   | セキュリティの質問（SSPR のみ）                       | 安全でない | 組み込みの安全でない一覧                    |
| `temporaryAccessPass`                | Temporary Access Pass                    | 中立    | 該当も失格もなし                        |

不明な Graph 値や将来の Graph 値は、オーバーライド パラメーターに明示的に列挙されていない限り、中立として扱われます。

### オーバーライド パラメーター

両方のオーバーライド パラメーターは既定で非表示で、RealmJoin runbook のカスタマイズ用です：

* **SecureMethodsOverride** — カンマ区切りの `methodsRegistered` 値の一覧で、安全なセットを定義します。これを設定すると、 **all** 方法グループのトグルは無視されます。例： `fido2SecurityKey,passKeyDeviceBound,passKeyDeviceBoundAuthenticator,windowsHelloForBusiness`
* **UnsecureMethodsOverride** — 組み込みの安全でない一覧を置き換えるカンマ区切りの一覧です。厳格モードでのみ評価されます。例： `mobilePhone,alternateMobilePhone,officePhone,email,securityQuestion,softwareOneTimePasscode`

不明な値は警告を出しますが、それでも評価されるため、このドキュメントが追いつく前でも将来の Graph 値を使用できます。

### メール レポートとダウンロード リンク

任意で、詳細レポートを配信できます。特に最初の実行を確認する場合に便利です（できれば dry run モードと組み合わせてください）：

* **レポートをメールで送信** (`SendEmail`、既定では無効）：構成済みの受信者にレポートを送信します。受信者フィールドは、メールが有効な場合にのみ表示されます。次の `RJReport.EmailSender` tenant 設定（ [RealmJoin レポート設定のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings)).
* **ファイルのダウンロード リンクを作成** (`CreateDownloadLink`、既定では無効）：レポート ファイルを Azure Storage Account にアップロードし、期限付きダウンロード リンクを返します（次を使用します `RJReport.StorageAccount.*` tenant 設定）。

レポート ファイルは、2 つのオプションのうち少なくとも 1 つが有効な場合にのみ生成されます。レポートの内容は次のとおりです：

* **mfa-secure-users-group-sync-changes.csv** — ユーザーごとの方法詳細を含む、実行済み（dry run では保留中）のすべての変更
* **mfa-secure-users-group-sync-all-users.csv** — すべてのメンバー ユーザーの評価：登録済み方法、安全/安全でないの分類、該当可否、除外理由、およびグループ メンバーシップ
* **mfa-secure-users-group-sync-report.xlsx** — 同じデータを整形済み Excel ブックとして出力したものです。選択したパラメーターと結果件数を含む "Info" 表紙シート、"Changes" ワークシート（追加ユーザーは緑、削除ユーザーは赤で強調表示）、および "All Users" ワークシートが含まれます

大規模な tenant では、未加工の CSV ファイルがメール添付のサイズ上限を超えることがあります（Graph は合計およそ 4 MB でメールを拒否します）。CSV ファイルが 2.5 MB の予算を超える場合、メールには Excel ブックのみを添付して送信し（完全なデータは圧縮形式で含まれます）、省略した旨の注記を付けます。サイズ超過で失敗した送信も、自動的にブックのみで再試行されます。ダウンロード リンクへのアップロードでは、サイズに関係なく常にすべてのファイルが含まれます。

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

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

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

### 注意事項と制限

* 登録レポートには **Entra ID P1 または P2** ライセンスが必要です。
* PIM 対象のロール割り当て（管理者除外）には **Entra ID P2** ライセンスが必要です。これがない場合、アクティブなロール割り当てのみが除外されます。
* レポートには次は含まれません： **無効化された** またはソフト削除されたユーザーです。これらのアカウントは次回の実行でグループから削除されます。
* レポート データは最近の登録変更に遅れることがあります。新しく登録された方法が反映されるまで、1 回の同期サイクルが必要な場合があります。
* runbook は、ページ分割されたレポート読み取りとバッチ化されたグループ書き込みを、自動スロットリング再試行付きで使い、大規模な tenant（2 万ユーザー超）を処理します。

### スケジュール設定

同期は冪等です。単一の繰り返しスケジュール（たとえば毎日）でグループは最新に保たれ、部分的な失敗後の再実行でも自動的に回復します。推奨：一度 **ドライラン（WhatIf）** を有効にして実行し、本番モードで runbook をスケジュールする前にジョブ出力を確認してください。

### 場所

組織 → セキュリティ → Sync MFA Secure Users To Group (Scheduled)

**Runbook の完全名**

rjgit-org\_security\_sync-MFA-secure-users-to-group\_scheduled

### 詳細

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

### アクセス許可

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

* **種類**：Microsoft Graph
  * AuditLog.Read.All
    * *各ユーザーの登録済み MFA 方法を評価するために userRegistrationDetails を読み取ります*
  * Group.Read.All
    * *対象グループと除外グループ、およびそれらの推移的なユーザー メンバーを読み取ります*
  * RoleManagement.Read.Directory
    * *ExcludeAdmins が有効な場合、ロール割り当てと適格スケジュールを読み取り、管理者ユーザーを除外します*
  * GroupMember.ReadWrite.All
    * *バッチ化された /groups/{id}/members/$ref 呼び出しを使用して、ターゲット グループのユーザーを追加および削除します*
  * User.Read.All
    * *管理者ロールのプリンシパルと ExcludeUserIds エントリをユーザー オブジェクトに解決します*
  * Organization.Read.All
    * */organization を読み取り、レポートの表紙とメールに使うテナント名を取得します*
  * Mail.Send *（任意 — 機能: メールレポート）*
    * *メール レポートが有効な場合、Send-RjReportEmail 経由でレポートメールを送信します*

### パラメーター

#### TargetGroupId

同期先の Entra ID グループ。このグループのメンバーは、この runbook によってのみ管理されます。

| プロパティ   | 値                                     |
| ------- | ------------------------------------- |
| 必須      | はい                                    |
| 既定値     |                                       |
| 種類      | 文字列                                   |
| ポータル表示名 | ターゲット グループ（セキュアな MFA 方法を持つユーザーを同期する先） |

#### IncludePasskeys

パスキーと FIDO2 セキュリティ キーを安全と見なしてカウントします (fido2SecurityKey, passKeyDeviceBound, passKeyDeviceBoundAuthenticator)。

| プロパティ   | 値                                |
| ------- | -------------------------------- |
| 必須      | いいえ                              |
| 既定値     | はい                               |
| 種類      | ブール値                             |
| ポータル表示名 | パスキー / FIDO2 セキュリティ キーは安全と見なされます |

#### IncludePlatformCredentials

プラットフォーム資格情報を安全と見なしてカウントします (windowsHelloForBusiness, passKeyDeviceBoundWindowsHello, macOsSecureEnclaveKey)。

| プロパティ   | 値                                                                         |
| ------- | ------------------------------------------------------------------------- |
| 必須      | いいえ                                                                       |
| 既定値     | はい                                                                        |
| 種類      | ブール値                                                                      |
| ポータル表示名 | プラットフォーム資格情報（Windows Hello for Business / macOS Secure Enclave）は安全と見なされます |

#### IncludeMicrosoftAuthenticator

Microsoft Authenticator アプリを安全と見なしてカウントします (microsoftAuthenticatorPush, microsoftAuthenticatorPasswordless)。

| プロパティ   | 値                                                           |
| ------- | ----------------------------------------------------------- |
| 必須      | いいえ                                                         |
| 既定値     | はい                                                          |
| 種類      | ブール値                                                        |
| ポータル表示名 | Microsoft Authenticator アプリ（プッシュ / パスワードレス サインイン）は安全と見なされます |

#### IncludeSoftwareOtp

ソフトウェア OTP / 認証アプリの TOTP を安全と見なしてカウントします (softwareOneTimePasscode)。

| プロパティ   | 値                                 |
| ------- | --------------------------------- |
| 必須      | いいえ                               |
| 既定値     | False                             |
| 種類      | ブール値                              |
| ポータル表示名 | ソフトウェア OTP（認証アプリの TOTP）は安全と見なされます |

#### IncludeHardwareOtp

ハードウェア OTP トークンを安全と見なしてカウントします (hardwareOneTimePasscode)。

| プロパティ   | 値                         |
| ------- | ------------------------- |
| 必須      | いいえ                       |
| 既定値     | False                     |
| 種類      | ブール値                      |
| ポータル表示名 | ハードウェア OTP トークンは安全と見なされます |

#### IncludeCertificateBasedAuth

証明書ベース認証を安全と見なしてカウントします (certificateBasedAuthentication)。

| プロパティ   | 値                  |
| ------- | ------------------ |
| 必須      | いいえ                |
| 既定値     | はい                 |
| 種類      | ブール値               |
| ポータル表示名 | 証明書ベース認証は安全と見なされます |

#### SecureOnly

厳格モード: いずれかの安全でない方法が登録されているユーザー（mobilePhone, alternateMobilePhone, officePhone, email, securityQuestion）は、たとえ安全な方法も持っていても、決して対象になりません。すでにメンバーの場合はグループから削除されます。

| プロパティ   | 値                                                    |
| ------- | ---------------------------------------------------- |
| 必須      | いいえ                                                  |
| 既定値     | False                                                |
| 種類      | ブール値                                                 |
| ポータル表示名 | 厳格モード: いずれかの安全でない方法（電話、メール、秘密の質問）を持つユーザーは決して対象になりません |

#### SecureMethodsOverride

オプション。安全なセットを定義する methodsRegistered 値のカンマ区切り一覧です。設定すると、すべての method group トグルは無視されます。既知の値の一覧は runbook のドキュメントを参照してください。

| プロパティ    | 値                                             |
| -------- | --------------------------------------------- |
| 必須       | いいえ                                           |
| 既定値      |                                               |
| 種類       | 文字列                                           |
| ポータル表示名  | 上級者向け: カスタムの安全な方法一覧（カンマ区切り、上記のすべてのトグルを置き換えます） |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定）                      |

#### UnsecureMethodsOverride

オプション。組み込みの安全でない一覧を置き換える methodsRegistered 値のカンマ区切り一覧です。厳格モード（SecureOnly）でのみ評価されます。

| プロパティ    | 値                                           |
| -------- | ------------------------------------------- |
| 必須       | いいえ                                         |
| 既定値      |                                             |
| 種類       | 文字列                                         |
| ポータル表示名  | 上級者向け: カスタムの安全でない方法一覧（カンマ区切り、組み込み一覧を置き換えます） |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定）                    |

#### ExcludeAdmins

管理者ユーザーを除外: Entra ID ディレクトリ ロールを持つユーザー（有効または PIM 対象、ロール割り当て可能グループのメンバーを含む）は決して対象にならず、すでにメンバーであればグループから削除されます。既定で有効です。ターゲット グループが SSPR を担う場合、管理者は第二要素の登録を強制されることになります。

| プロパティ   | 値                                   |
| ------- | ----------------------------------- |
| 必須      | いいえ                                 |
| 既定値     | はい                                  |
| 種類      | ブール値                                |
| ポータル表示名 | 管理者ユーザーを除外（ディレクトリ ロール保持者、PIM 対象を含む） |

#### ExcludeGroupId

オプションの除外グループ: このグループの推移的なユーザー メンバー（例: break glass アカウントやサービス アカウント）は決して対象にならず、すでにメンバーであればグループから削除されます。

| プロパティ   | 値                               |
| ------- | ------------------------------- |
| 必須      | いいえ                             |
| 既定値     |                                 |
| 種類      | 文字列                             |
| ポータル表示名 | 除外グループ（メンバーはターゲット グループに同期されません） |

#### ExcludeUserIds

個別に除外するユーザーのオプション一覧: これらのユーザーは決して対象にならず、すでにメンバーであればグループから削除されます。ユーザー オブジェクト ID とユーザー プリンシパル名を受け付けます。解決できないエントリは警告付きで無視されます。

| プロパティ   | 値                             |
| ------- | ----------------------------- |
| 必須      | いいえ                           |
| 既定値     | @()                           |
| 種類      | String\[]                     |
| ポータル表示名 | 除外されたユーザー（ターゲット グループに同期されません） |

#### WhatIfMode

ドライラン: グループを変更せずに、どのユーザーが追加または削除されるかをログに記録します。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | いいえ              |
| 既定値     | False            |
| 種類      | ブール値             |
| ポータル表示名 | ドライラン（ログのみ、変更なし） |

#### SendEmail

有効にすると、レポートは CSV と Excel（xlsx）の添付ファイル付きでメール送信されます。既定では無効です。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | いいえ              |
| 既定値     | False            |
| 種類      | ブール値             |
| ポータル表示名 | レポートをメールで送信しますか? |

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

| ポータルオプション           | 値 |
| ------------------- | - |
| はい - レポートをメールで送信します |   |
| いいえ - メールを送信しません    |   |

#### EmailTo

レポートの宛先メール アドレス。単一のアドレス、またはカンマ区切りの複数アドレス（文字列）を指定できます。SendEmail が有効な場合にのみ使用されます。

| プロパティ   | 値           |
| ------- | ----------- |
| 必須      | いいえ         |
| 既定値     |             |
| 種類      | 文字列         |
| ポータル表示名 | 受信者のメールアドレス |

#### EmailFrom

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

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

#### BrandingHeaderImageUrl

レポートメール用のカスタム ヘッダー画像（PNG/JPEG/GIF、最大 200 KB）の任意の公開 HTTPS URL です。RJReport.Branding.HeaderImageUrl テナント設定から取得されます。空の場合は、既定の RealmJoin ヘッダー グラフィックが使用されます。

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

#### BrandingFooterImageUrl

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

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

#### BrandingFooterLink

フッター画像のリンク先となる任意の URL です。RJReport.Branding.FooterLink テナント設定から取得されます。空の場合は、既定のリンク（<https://www.realmjoin.com）が使用されます。>

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

#### BrandingAccentColor

レポートメール テンプレート用のアクセントカラーの任意の上書き（6 桁の hex、例: '#0052cc'）です。RJReport.Branding.AccentColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin アクセントカラーが使用されます。

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

#### BrandingTextColor

レポートメール テンプレート用のテキストカラーの任意の上書き（6 桁の hex）です。RJReport.Branding.TextColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin テキストカラーが使用されます。

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

#### ReportFileFormat

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

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

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

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

#### CreateDownloadLink

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

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

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

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

#### ContainerName

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

| プロパティ    | 値                              |
| -------- | ------------------------------ |
| 必須       | いいえ                            |
| 既定値      | sync-mfa-secure-users-to-group |
| 種類       | 文字列                            |
| ポータルで非表示 | はい（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/security/sync-mfa-secure-users-to-group_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.