> 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 セキュア ユーザーをグループに同期（スケジュール済み）

安全な MFA 方法を登録したユーザーでグループを満たす

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

### 説明

パスキーや Microsoft Authenticator アプリなど、少なくとも1つの安全な認証方法を登録したユーザーと Entra ID グループを同期します。安全な方法を失ったユーザーは削除されます。たとえばグループがセルフサービス パスワード リセットを制御する場合、管理者、除外グループ、個別ユーザーを対象外にできます。ドライランでは変更内容のみが表示され、レポートはメールで送信するかダウンロード リンクとして提供できます。オプションの詳細は、ランブック ドキュメント（docs.realmjoin.com）を参照してください。

### 仕組み

ランブックは Entra ID の [認証方法登録レポート](https://learn.microsoft.com/en-us/graph/api/authenticationmethodsroot-list-userregistrationdetails) (`userRegistrationDetails`）を読み取り、対象グループをすべての **メンバー ユーザー** と照合します。対象となる条件:

* ユーザーは、登録済みの方法の少なくとも1つが構成済みの **安全な** セットに含まれる場合に対象となります。
* で **厳格モード** (`SecureOnly`）では、ユーザーはさらに **安全でない** セットの方法を一切登録していない必要があります。SMS 要素も保持しているパスキー ユーザーは対象外です。
* まだグループ メンバーでない対象ユーザーは追加され、対象ではなくなったメンバーは削除されます（ミラー同期）。
* ゲスト ユーザーが追加または削除されることはありません。ユーザー以外のグループ メンバー（デバイス、サービス プリンシパル、入れ子になったグループ）には一切変更を加えません。

対象グループは、このランブックだけで管理する必要があります。

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

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

| トグル                         | 既定値 | 対象となる値                                                                               |
| --------------------------- | --- | ------------------------------------------------------------------------------------ |
| パスキー / FIDO2 セキュリティ キー      | オン  | `fido2SecurityKey`, `passKeyDeviceBound`, `passKeyDeviceBoundAuthenticator`          |
| プラットフォーム資格情報                | オン  | `windowsHelloForBusiness`, `passKeyDeviceBoundWindowsHello`, `macOsSecureEnclaveKey` |
| Microsoft Authenticator アプリ | オン  | `microsoftAuthenticatorPush`, `microsoftAuthenticatorPasswordless`                   |
| ソフトウェア OTP                  | オフ  | `softwareOneTimePasscode`                                                            |
| ハードウェア OTP                  | オフ  | `hardwareOneTimePasscode`                                                            |
| 証明書ベースの認証                   | オン  | `certificateBasedAuthentication`                                                     |

### 厳格モード（SecureOnly）

厳格モードが有効な場合、次の組み込みの安全でない方法をいずれか1つでも持つユーザーは対象になりません。

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

ある方法が安全なセットと安全でないセットの両方に含まれる場合（オーバーライド パラメーターを介してのみ可能）、安全でない方が優先されます。このようなユーザーは厳格モードでは対象になりません。ランブックは起動時にこれについて警告します。

### 除外

除外されたユーザーは、登録済みの方法に関係なく対象になりません。対象グループに追加されることはなく、すでにメンバーである場合は削除されます。ユーザーごとのレポートには、理由が次の `ExclusionReason` 列に表示されます。

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

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

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

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

このオプションには、追加の Graph 権限が必要です `RoleManagement.Read.Directory` （マネージド ID 用）。

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

構成したグループの推移的なユーザー メンバーは除外されます。これは、同期で決して管理してはならないアカウント（例： **緊急アクセス アカウント** または **サービス アカウント**）を対象としています。入れ子になったグループも考慮されます。除外グループを対象グループ自体にすることはできません。

#### 個別に除外するユーザー（`ExcludeUserIds`、任意）

個別ユーザーは、複数ユーザー ピッカーで直接除外できます。これは、専用の除外グループを維持するほどではない一時的な除外に使用します。リストにはユーザーの **オブジェクト ID** および **ユーザー プリンシパル名** （UPN）を指定できます。解決できないエントリ（削除済みアカウントなど）は警告がログに記録され無視されるため、古いエントリによってスケジュールされた同期が失敗することはありません。

#### ランブックのカスタマイズによる除外の管理（ピッカーなし）

両方の除外パラメーターは、次を使用して一元的に事前設定できます。 [JSON ベースのランブックのカスタマイズ](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) （RealmJoin ポータル： **設定** → **ランブックのカスタマイズ**）。除外が Tenant に対して固定されており、ランブックの開始またはスケジュール時に毎回手動で選択すべきでない場合に便利です。

```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** 単一のグループ **オブジェクト ID** （GUID）をプレーン文字列として受け取ります。Entra 管理センターまたは RealmJoin ポータルのグループ概要ページからコピーしてください。
* **ExcludeUserIds** JSON の **文字列配列**を受け取ります。各エントリはユーザーの **オブジェクト ID** または **UPN**にできます。エントリはトリミングおよび重複除去され、ランブックが起動時に解決します。
* **推奨事項：** ランブックのカスタマイズを通じて除外を管理する場合は、次も設定してください `"Hide": true` をパラメーターに設定します（上記の例のとおり）。これにより開始フォームから完全に削除され、ランブックの開始またはスケジュール時に、中央で構成された除外を UI で上書きできなくなります。 `Hide`がない場合、構成された値は事前入力として表示されるだけで、そこで変更できます。

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

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

| `methodsRegistered` 値                | 表示名                                     | 分類    | トグルの対象（既定値）                     |
| ------------------------------------ | --------------------------------------- | ----- | ------------------------------- |
| `fido2SecurityKey`                   | FIDO2 セキュリティ キー                         | 安全    | パスキー / FIDO2（オン）                |
| `passKeyDeviceBound`                 | パスキー（デバイス バインド）                         | 安全    | パスキー / FIDO2（オン）                |
| `passKeyDeviceBoundAuthenticator`    | Microsoft Authenticator のパスキー           | 安全    | パスキー / 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`                        | Office の電話（音声通話）                        | 安全でない | 組み込みの安全でないリスト                   |
| `email`                              | メール（SSPR のみ）                            | 安全でない | 組み込みの安全でないリスト                   |
| `securityQuestion`                   | セキュリティの質問（SSPR のみ）                      | 安全でない | 組み込みの安全でないリスト                   |
| `temporaryAccessPass`                | Temporary Access Pass                   | 中立    | 対象にも非対象にもならない                   |

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

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

両方のオーバーライド パラメーターは既定で非表示であり、RealmJoin ランブックのカスタマイズを目的としています。

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

不明な値は警告を生成しますが、引き続き評価されます。そのため、このドキュメントが更新される前でも将来の Graph 値を使用できます。

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

必要に応じて、詳細なレポートを配信できます。特に最初の実行を確認する際に便利です（理想的にはドライラン モードと組み合わせます）。

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

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

* **mfa-secure-users-group-sync-changes.csv** - 実行されたすべての変更（またはドライランでは保留中の変更）と、ユーザーごとの方法の詳細
* **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 桁の 16 進数値、例: `#0052cc`

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

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

### 注記と制限

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

### スケジューリング

同期はべき等です。単一の定期スケジュール（例：毎日）でグループを最新の状態に維持でき、部分的な失敗後の再実行によって自動修復されます。推奨事項：まず次を使用して1回実行してください。 **ドライラン（WhatIf）** を有効にし、ライブ モードでランブックをスケジュールする前にジョブ出力を確認してください。

### 場所

組織 → セキュリティ → MFA 安全ユーザーをグループに同期（スケジュール）

**完全な Runbook 名**

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

### 詳細

| プロパティ    | 値                                                                                                                  |
| -------- | ------------------------------------------------------------------------------------------------------------------ |
| バージョン    | 1.5.0                                                                                                              |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<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
    * *レポート表紙シートおよびメール用の Tenant 名を取得するために /organization を読み取ります*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *メール レポートが有効な場合、Send-RjReportEmail 経由でレポート メールを送信します*

### パラメーター

#### TargetGroupId

このランブックがメンバーを管理するグループです。対象ではなくなったメンバーは削除されます。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | true   |
| 既定値     |        |
| 種類      | 文字列    |
| ポータル表示名 | 対象グループ |

#### IncludePasskeys

フィッシング耐性を持つパスキーと FIDO2 セキュリティ キーは、安全と見なされます。

| プロパティ   | 値                         |
| ------- | ------------------------- |
| 必須      | false                     |
| 既定値     | True                      |
| 種類      | ブール値                      |
| ポータル表示名 | パスキーと FIDO2 キーを安全と見なしますか？ |

#### IncludePlatformCredentials

Windows Hello for Business および macOS プラットフォーム資格情報は安全と見なされます。

| プロパティ   | 値                       |
| ------- | ----------------------- |
| 必須      | false                   |
| 既定値     | True                    |
| 種類      | ブール値                    |
| ポータル表示名 | プラットフォーム資格情報を安全と見なしますか？ |

#### IncludeMicrosoftAuthenticator

プッシュまたはパスワードレス サインインを使用する Microsoft Authenticator アプリは、安全と見なされます。

| プロパティ   | 値                                   |
| ------- | ----------------------------------- |
| 必須      | false                               |
| 既定値     | True                                |
| 種類      | ブール値                                |
| ポータル表示名 | Microsoft Authenticator を安全と見なしますか？ |

#### IncludeSoftwareOtp

認証アプリによる時間ベースのワンタイム コードは、安全と見なされます。

| プロパティ   | 値                      |
| ------- | ---------------------- |
| 必須      | false                  |
| 既定値     | False                  |
| 種類      | ブール値                   |
| ポータル表示名 | ソフトウェア OTP を安全と見なしますか？ |

#### IncludeHardwareOtp

ハードウェア ワンタイム パスワード トークンは、安全と見なされます。

| プロパティ   | 値                          |
| ------- | -------------------------- |
| 必須      | false                      |
| 既定値     | False                      |
| 種類      | ブール値                       |
| ポータル表示名 | ハードウェア OTP トークンを安全と見なしますか？ |

#### IncludeCertificateBasedAuth

たとえばスマート カードの証明書を使用したサインインは、安全と見なされます。

| プロパティ   | 値                    |
| ------- | -------------------- |
| 必須      | false                |
| 既定値     | True                 |
| 種類      | ブール値                 |
| ポータル表示名 | 証明書ベースの認証を安全と見なしますか？ |

#### SecureOnly

厳格モード：安全な方法を持っていても、電話、メール、またはセキュリティの質問の方法も登録しているユーザーは対象になりません。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | false  |
| 既定値     | False  |
| 種類      | ブール値   |
| ポータル表示名 | 厳格モード？ |

#### SecureMethodsOverride

安全と見なす方法名のカスタム リストです。コンマで区切ります。設定すると、個別の方法スイッチは無視されます。ランブックのカスタマイズで事前設定します。方法名はランブック ドキュメントに記載されています。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータル表示名  | カスタムの安全な方法                |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### UnsecureMethodsOverride

厳格モードで安全でないと見なす方法名のカスタム リストです。コンマで区切ります。ランブックのカスタマイズで事前設定します。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータル表示名  | カスタムの安全でない方法              |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### ExcludeAdmins

アクティブまたは対象の Entra ID ディレクトリ ロールを持つユーザーは決して対象にならず、グループから削除されます。グループがセルフサービス パスワード リセットを制御する場合に便利です。

| プロパティ   | 値           |
| ------- | ----------- |
| 必須      | false       |
| 既定値     | True        |
| 種類      | ブール値        |
| ポータル表示名 | 管理者を除外しますか？ |

#### ExcludeGroupId

このグループのメンバー（緊急アクセス アカウントやサービス アカウントなど）は決して対象にならず、対象グループから削除されます。対象がない場合は空のままにしてください。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | false  |
| 既定値     |        |
| 種類      | 文字列    |
| ポータル表示名 | 除外グループ |

#### ExcludeUserIds

決して対象にならず、対象グループから削除されるユーザーです。複数選択できます。

| プロパティ   | 値         |
| ------- | --------- |
| 必須      | false     |
| 既定値     | @()       |
| 種類      | String\[] |
| ポータル表示名 | 除外されたユーザー |

#### WhatIfMode

グループを変更せずに、追加または削除されるユーザーのみをログに記録します。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | false  |
| 既定値     | False  |
| 種類      | ブール値   |
| ポータル表示名 | ドライラン？ |

#### SendEmail

実行後にメールでレポートを送信します。

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

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

| ポータル オプション         | 値     |
| ------------------ | ----- |
| はい - メールでレポートを送信する | true  |
| いいえ - メールを送信しない    | false |

#### EmailTo

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

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

#### ReportFileFormat

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

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

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

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

#### CreateDownloadLink

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

| プロパティ   | 値                  |
| ------- | ------------------ |
| 必須      | false              |
| 既定値     | False              |
| 種類      | ブール値               |
| ポータル表示名 | ダウンロード リンクを作成しますか？ |

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

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

#### コンテナー名

レポート ファイルがアップロードされるストレージ コンテナーです。runbook ごとに設定します。

| プロパティ    | 値                              |
| -------- | ------------------------------ |
| 必須       | false                          |
| 既定値      | sync-mfa-secure-users-to-group |
| 種類       | 文字列                            |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定)      |

#### リソース グループ名

レポート アップロード用のストレージ アカウントのリソース グループです。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得されます。

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

#### Storage Account 名

レポート アップロード用の Storage Account です。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得されます。

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

#### LinkExpiryDays

ダウンロード リンクが有効なままの期間（日数）です。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得されます。

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

[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/security/sync-mfa-secure-users-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.