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

### 説明

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

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

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

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

### ステータスの種類

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

### データ保持と期間

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

### 出力およびレポート ファイル

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

### レポート配信

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

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

次の前に作成されたスケジュールは **レポート配信** オプションが存在していた場合でも、保存された受信者だけで引き続きそのメール送信が有効になります。このようなスケジュールを編集のために開くと、オプションは *Output Data のみ*と表示されます。保存する前に配信方法を再度選択してください。そうしないと、スケジュールはレポートの送信を停止します。

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

メールレポートの送信は任意であり、次の場合にのみ行われます。 *レポートもメール送信* または *メール送信とダウンロードリンクも追加* レポート配信として選択されると、受信者が必要になります。送信者アドレスは `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.4.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: Automation Account のマネージド ID に対してターゲットの Storage Account 上で 'Reader and Data Access' ロールを付与します。アップロードでは listKeys を使用してアカウント キーを取得します（ダウンロードリンクのオプションでのみ必要です）

### パラメーター

#### 承認済みを含める

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

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

#### 拒否を含める

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

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | false          |
| 既定値     | True           |
| 種類      | ブール値           |
| ポータル表示名 | 拒否された要求を含めますか? |

#### 期限切れを含める

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

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

#### 取り消しを含める

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

| プロパティ   | 値               |
| ------- | --------------- |
| 必須      | false           |
| 既定値     | True            |
| 種類      | ブール値            |
| ポータル表示名 | 取り消された要求を含めますか? |

#### 保留中を含める

まだ判断を待っている要求を含めます。

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

#### 完了を含める

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

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

#### 経過日数の上限

作成後この日数以内の要求のみがレポートされます。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 のカスタマイズで事前設定) |

#### コンテナー名

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

| プロパティ    | 値                             |
| -------- | ----------------------------- |
| 必須       | false                         |
| 既定値      | report-epm-elevation-requests |
| 種類       | 文字列                           |
| ポータルで非表示 | はい (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/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.