For the complete documentation index, see llms.txt. This page is also available as Markdown.

EPM 昇格要求をレポート(スケジュール済み)

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

これはスケジュール済みの runbook です。単一のオブジェクトでトリガーされるのではなく、定期的なスケジュールで実行されるように設計されています。詳細は スケジューリング runbook のスケジュールを構成する方法の詳細については

説明

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

目的とユースケース

  • Endpoint Privilege Management (EPM) アクティビティの定期レポート

  • 承認済みおよび拒否された昇格要求の監査証跡

  • 期限切れ要求の分析によるプロセスのボトルネック特定

  • 自動昇格ルール用に頻繁に要求されるアプリケーションの特定

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

ステータスの種類

  • 保留中: 管理者の判断待ちです(時間に敏感なアラートには Monitor Pending EPM Requests を使用してください)

  • 承認済み: 管理者が要求を承認しました。ユーザーは昇格を続行できます

  • 拒否済み: セキュリティまたはポリシー上の懸念により、管理者が要求を拒否しました

  • 期限切れ: 管理者が確認する前に要求の期限が切れました。応答時間が遅いことを示している可能性があります

  • 取り消し済み: 以前承認された昇格が後から管理者によって取り消されました

  • 完了済み: 承認後、ユーザーが昇格されたアプリケーションを正常に実行しました

データ保持と期間

  • Intune は作成後 30 日間、EPM 要求の詳細を保持します。

  • 長期分析には、Intune の外部に CSV エクスポートをアーカイブしてください。

  • 既定のフィルターでは、過去 30 日間の承認済み、拒否済み、期限切れ、取り消し済みの状態を対象にします。

出力とレポート ファイル

  • 実行の [Output Data] タブには 概要 テーブルが件数と、選択した各ステータスごとの 1 つのテーブルを表示します(例: 承認済みの要求)、古い要求が先です。

  • レポート ファイルには、タイムスタンプ、ユーザー、デバイス、アプリケーション、正当化理由、ファイル ハッシュを含む一致したすべての要求の詳細が保持されます。選択したレポート ファイル形式に応じて、CSV および/または Excel (xlsx) として生成されます。

  • プライバシー保護のため、メールは受信者ごとに個別に送信されます。

  • 要求がフィルター条件に一致しない場合、メールは送信されず、ファイルも作成されません。そのような実行は正常に完了し、[Output Data] タブには引き続き概要が表示されます。

レポートの配信

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

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

次より前に作成されたスケジュールは、 レポートの配信 オプションが存在していなかった頃からメール送信を継続します。保存済みの宛先だけでも、そのスケジュールのメール送信は有効になります。そのようなスケジュールを編集のために開くと、オプションには Output Dataのみと表示されます。保存する前にもう一度配信方法を選択してください。そうしないと、そのスケジュールはレポートの送信を停止します。

メール送信に関する設定

メール レポートの送信は任意で、次の場合にのみ行われます レポートもメール送信する または レポートもメール送信し、ダウンロードリンクを付ける がレポート配信として選択されている場合、受信者が必要になります。送信者アドレスは次の場所から取得されます: RJReport.EmailSender Tenant 設定から取得されます。

この runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、runbook のカスタマイズで既存のメール アドレスを設定する必要があります。

詳細については RealmJoin Report Settings のドキュメント を参照してください。

メールのブランド設定

レポート メールでは、任意の RJReport.Branding.* Tenant 設定が使用されます:

  • ヘッダーおよびフッター画像 - 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB

  • フッター リンク - フッター画像の対象

  • アクセント カラーとテキスト カラー - 6桁の16進値、例: #0052cc

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

設定手順と画像要件: メールのブランド設定.

場所

組織 → セキュリティ → Report EPM Elevation Requests (Scheduled)

Runbook の完全名

rjgit-org_security_report-EPM-elevation-requests_scheduled

詳細

プロパティ
値

バージョン

1.4.0

必要なモジュール

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)

スケジュール可能

はい

権限

アプリケーションの権限

  • 種類: Microsoft Graph

    • DeviceManagementConfiguration.Read.All

      • ステータスと作成日時で Endpoint Privilege Management の elevationRequests を照会してレポートを作成します

    • Mail.Send (任意 — 機能: メール レポート)

      • メール配信が選択されている場合、Send-RjRbReportEmail を使用して CSV/XLSX 添付ファイル付きのレポート メールを送信します

    • Organization.Read.All (任意 — 機能: メール レポート)

      • メール件名、メール本文、レポート ファイル名に使用する Tenant の表示名と ID を読み取ります

権限に関する注意

Azure Storage Account: ターゲットの Storage Account に対する Automation Account のマネージド ID に 'Storage Account Contributor' ロールが必要です。アップロードでは 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

レポート メールの送信元アドレス。Tenant 設定 RJReport.EmailSender から取得されます。

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

BrandingHeaderImageUrl

レポート メールのヘッダー画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。Tenant 設定 RJReport.Branding.HeaderImageUrl から取得されます。空欄の場合は既定の RealmJoin ヘッダーが使用されます。

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

BrandingFooterImageUrl

レポート メールのフッター画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。Tenant 設定 RJReport.Branding.FooterImageUrl から取得されます。空欄の場合は既定の RealmJoin フッターが使用されます。

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

レポート メールのフッター画像のリンク先。Tenant 設定 RJReport.Branding.FooterLink から取得されます。空欄の場合は realmjoin.com が使用されます。

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

BrandingAccentColor

レポート メールのアクセント カラー。6 桁の 16 進値で指定します。Tenant 設定 RJReport.Branding.AccentColor から取得されます。空欄または無効な場合は RealmJoin の既定値が使用されます。

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

BrandingTextColor

レポート メールのテキスト カラー。6 桁の 16 進値で指定します。Tenant 設定 RJReport.Branding.TextColor から取得されます。空欄または無効な場合は RealmJoin の既定値が使用されます。

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

ReportFileFormat

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

プロパティ
値

必須

false

既定値

CSV と XLSX

種類

文字列

ポータルの表示名

レポート ファイル形式

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

ポータル オプション

ポータル オプション
値

CSV と XLSX

CSV と XLSX

CSV のみ

CSV のみ

XLSX のみ

XLSX のみ

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

プロパティ
値

必須

false

既定値

False

種類

ブール値

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

ContainerName

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

プロパティ
値

必須

false

既定値

report-epm-elevation-requests

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

ResourceGroupName

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

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

StorageAccountName

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

プロパティ
値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

LinkExpiryDays

ダウンロード リンクが有効なままの期間(日数)。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

プロパティ
値

必須

false

既定値

6

種類

Int32

ポータルでは非表示

はい(runbook のカスタマイズで事前設定)

最終更新

役に立ちましたか?