> 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/report-epm-elevation-requests_scheduled.md).

# EPM 昇格要求をレポート（スケジュール済み）

状態と経過時間ごとに EPM 昇格要求をレポート

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

### 説明

Intune から Endpoint Privilege Management の昇格要求を収集し、ステータスと作成されてからの経過時間で絞り込みます。要求はステータスごとに一覧化され、件数の要約も表示されます。Intune は要求の詳細を 30 日間保持するため、それより古い要求はレポートできません。レポートはメールで送信することも、ダウンロードリンクとして提供することもできます。

### 目的とユースケース

* Endpoint Privilege Management (EPM) アクティビティの定期レポート
* 承認済みおよび拒否済みの昇格要求の監査証跡
* 期限切れ要求の分析によるプロセスのボトルネックの特定
* 自動昇格ルールのための頻繁に要求されるアプリケーションの特定

月次スケジュールを推奨します。

### ステータスの種類

* **保留中:** 管理者の判断待ちです（ **保留中の EPM 要求を監視** を使用して、時間に厳しいアラートを行います）
* **承認済み:** 管理者が要求を承認し、ユーザーは昇格を続行できます
* **拒否済み:** 管理者がセキュリティまたはポリシー上の懸念から要求を拒否しました
* **期限切れ:** 管理者が確認する前に要求の期限が切れたもので、応答時間の遅さを示している可能性があります
* **取り消し済み:** 以前に承認された昇格が、後で管理者によって取り消されました
* **完了済み:** ユーザーは承認後に昇格されたアプリケーションを正常に実行しました

### データ保持と時間範囲

* Intune は、作成後 30 日間 EPM 要求の詳細を保持します。
* 長期分析には、CSV エクスポートを Intune の外部にアーカイブしてください。
* 既定のフィルターでは、過去 30 日間の承認済み、拒否済み、期限切れ、および取り消し済みの状態が対象になります。

### 出力とレポート ファイル

* 実行の出力データタブには *概要* 件数を示すテーブルと、選択した各ステータスごとのテーブルが 1 つ表示されます（例: *承認済みの要求*）、最も古い要求が先頭になります。
* レポート ファイルには、タイムスタンプ、ユーザー、デバイス、アプリケーション、正当化、およびファイル ハッシュを含む、条件に一致したすべての要求の詳細が保持されます。選択したレポート ファイル形式に応じて、CSV および/または Excel (xlsx) として生成されます。
* プライバシー保護のため、メールは受信者ごとに個別に送信されます。
* 要求がフィルター条件に一致しない場合、メールは送信されず、ファイルも作成されません。その場合でも実行は正常に完了し、出力データタブには引き続き要約が表示されます。

### レポートの配信

レポート ファイルは、配信方法が次の **レポートの配信** オプション（メールおよび/またはダウンロードリンク）で選択された場合にのみ生成されます。この場合は *出力データのみ* 選択すると、結果は RealmJoin ポータルの Output Data タブで直接読み取られ、各テーブルは Excel にもエクスポートできます。メール配信とダウンロード リンクの生成は独立しており、両方を組み合わせることができます。

ダウンロードリンクの場合、レポート ファイルは、Azure Storage Account に構成された `RJReport.StorageAccount.*` テナント設定にアップロードされ、期限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは、Automation アカウントのマネージド ID で認証されます。その ID には **Reader and Data Access** 対象の Storage Account に対する RBAC ロールが必要です（これは Azure RBAC の割り当てであり、Graph のアプリケーション権限ではありません）。

次の設定が存在する前に作成されたスケジュールは **レポートの配信** オプションが存在していてもメールの送信を継続します。保存された受信者だけでも、そのスケジュールではメールが有効になります。そのようなスケジュールを編集用に開くと、オプションには *出力データのみ*が表示されます。保存する前に配信方法をもう一度選択してください。そうしないと、スケジュールはレポートの送信を停止します。

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

メール レポートの送信は任意であり、 *レポートもメール送信* または *レポートもメール送信とダウンロードリンク* がレポート配信として選択されます。その場合、受信者が必要です。送信者アドレスは次から取得されます。 `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 → Security → Report EPM Elevation Requests (Scheduled)

**完全な Runbook 名**

rjgit-org\_security\_report-EPM-elevation-requests\_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
  * DeviceManagementConfiguration.Read.All
    * *ステータスと作成日で Endpoint Privilege Management の elevationRequests を照会し、レポートを作成します*
  * Mail.Send *（任意 — 機能: メール レポート）*
    * *メール配信が選択されている場合、Send-RjRbReportEmail を使用して CSV/XLSX 添付ファイル付きのレポート メールを送信します*
  * Organization.Read.All *（任意 — 機能: メール レポート）*
    * *メールの件名、メール本文、およびレポート ファイル名のためにテナントの表示名と ID を読み取ります*

#### 権限に関する注意事項

Azure Storage Account: 対象 Storage Account 上の Automation アカウントのマネージド ID に対する 'Reader and Data Access' ロール - アップロードでは listKeys 経由でアカウント キーを取得します（ダウンロードリンク オプションでのみ必要です）

### パラメーター

#### IncludeApproved

管理者が承認した要求を含めます。

| プロパティ    | 値              |
| -------- | -------------- |
| 必須       | false          |
| 既定値      | True           |
| 型        | ブール値           |
| ポータルの表示名 | 承認済みの要求を含めますか? |

#### IncludeDenied

管理者が拒否した要求を含めます。

| プロパティ    | 値              |
| -------- | -------------- |
| 必須       | false          |
| 既定値      | True           |
| 型        | ブール値           |
| ポータルの表示名 | 拒否済みの要求を含めますか? |

#### IncludeExpired

判断が下される前に期限切れになった要求を含めます。

| プロパティ    | 値              |
| -------- | -------------- |
| 必須       | false          |
| 既定値      | True           |
| 型        | ブール値           |
| ポータルの表示名 | 期限切れの要求を含めますか? |

#### IncludeRevoked

後で承認が取り消された要求を含めます。

| プロパティ    | 値                |
| -------- | ---------------- |
| 必須       | false            |
| 既定値      | True             |
| 型        | ブール値             |
| ポータルの表示名 | 取り消し済みの要求を含めますか? |

#### IncludePending

まだ判断待ちの要求を含めます。

| プロパティ    | 値             |
| -------- | ------------- |
| 必須       | false         |
| 既定値      | False         |
| 型        | ブール値          |
| ポータルの表示名 | 保留中の要求を含めますか? |

#### IncludeCompleted

承認され、使用された要求を含めます。

| プロパティ    | 値              |
| -------- | -------------- |
| 必須       | false          |
| 既定値      | False          |
| 型        | ブール値           |
| ポータルの表示名 | 完了済みの要求を含めますか? |

#### MaxAgeInDays

この日数以内に作成された要求のみがレポートされます。Intune は要求の詳細を 30 日間保持するため、より大きい値は 30 に切り詰められます。

| プロパティ    | 値        |
| -------- | -------- |
| 必須       | false    |
| 既定値      | 30       |
| 型        | Int32    |
| ポータルの表示名 | 作成からの日数内 |

#### SendEmailReport

レポートを受信者のメールアドレスに送信します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### EmailTo

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

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルの表示名 | 受信者のメール アドレス             |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### 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                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ContainerName

レポート ファイルをアップロードする Storage container。runbook ごとに設定します。

| プロパティ    | 値                             |
| -------- | ----------------------------- |
| 必須       | false                         |
| 既定値      | report-epm-elevation-requests |
| 型        | 文字列                           |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定）      |

#### ResourceGroupName

レポート アップロード用の Storage Account のリソース グループ。テナント設定 RJReport.StorageAccount.ResourceGroup から取得します。

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

#### StorageAccountName

レポート アップロード用の Storage Account。テナント設定 RJReport.StorageAccount.StorageAccountName から取得します。

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

#### SubscriptionId

レポート アップロード用の Storage Account のサブスクリプション ID。テナント設定 RJReport.StorageAccount.SubscriptionId から取得します。空の場合は、管理対象 ID がサインインするサブスクリプションが使用されます。

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

#### LinkExpiryDays

ダウンロード リンクの有効期間（日数）。テナント設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

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

[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/security/report-epm-elevation-requests_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.
