> 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/de/automatisierung/runbooks/runbook-references/org/security/report-epm-elevation-requests_scheduled.md).

# Bericht über EPM-Eskalierungsanfragen, geplant

EPM-Eskalierungsanfragen nach Status und Alter melden

{% hint style="info" %}
Dies ist ein geplanter Runbook-Lauf. Er ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, anstatt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Planung](/de/automatisierung/runbooks/scheduling.md) für Details dazu, wie Runbook-Zeitpläne konfiguriert werden.
{% endhint %}

### Beschreibung

Sammelt die Elevation-Anfragen von Endpoint Privilege Management aus Intune, gefiltert nach Status und danach, wie lange sie bereits zurückliegen. Die Anfragen werden je Status mit einer Zusammenfassung der Anzahl aufgeführt. Intune speichert Anfragedetails 30 Tage lang, daher können ältere Anfragen nicht gemeldet werden. Der Bericht kann per E-Mail gesendet oder als Download-Link bereitgestellt werden.

### Zweck und Anwendungsfälle

* Regelmäßige Berichterstattung über Aktivitäten von Endpoint Privilege Management (EPM)
* Prüfpfad für genehmigte und abgelehnte Elevation-Anfragen
* Analyse abgelaufener Anfragen zur Identifizierung von Engpässen im Prozess
* Identifizierung häufig angeforderter Anwendungen für automatische Elevation-Regeln

Ein monatlicher Zeitplan wird empfohlen.

### Statustypen

* **Ausstehend:** wartet auf eine Administratorentscheidung (verwenden Sie **Ausstehende EPM-Anfragen überwachen** für zeitkritische Warnmeldungen)
* **Genehmigt:** ein Administrator hat die Anfrage genehmigt; der Benutzer kann mit der Erhöhung fortfahren
* **Abgelehnt:** ein Administrator hat die Anfrage aus Sicherheits- oder Richtliniengründen abgelehnt
* **Abgelaufen:** die Anfrage ist abgelaufen, bevor ein Administrator sie geprüft hat, was auf langsame Reaktionszeiten hindeuten kann
* **Widerrufen:** eine zuvor genehmigte Erhöhung wurde später von einem Administrator widerrufen
* **Abgeschlossen:** der Benutzer hat die erhöhte Anwendung nach der Genehmigung erfolgreich ausgeführt

### Datenspeicherung und Zeiträume

* Intune speichert EPM-Anfragedetails 30 Tage nach der Erstellung.
* Archivieren Sie die CSV-Exporte für die Langzeitanalyse außerhalb von Intune.
* Der Standardfilter umfasst die Status Genehmigt, Abgelehnt, Abgelaufen und Widerrufen der letzten 30 Tage.

### Ausgabe- und Berichtdateien

* Die Registerkarte „Ausgabedaten“ des Laufs zeigt eine *Zusammenfassung* Tabelle mit den Zählwerten und eine Tabelle pro ausgewähltem Status (zum Beispiel *genehmigte Anfragen*), die älteste Anfrage zuerst.
* Die Berichtsdateien enthalten jede passende Anfrage mit allen Details: Zeitstempel, Benutzer, Geräte, Anwendungen, Begründungen und Dateihashes. Sie werden als CSV und/oder Excel (xlsx) erzeugt, abhängig vom ausgewählten Berichtsdateiformat.
* E-Mails werden aus Datenschutzgründen einzeln an jeden Empfänger gesendet.
* Es wird keine E-Mail gesendet und keine Datei erstellt, wenn keine Anfrage die Filterkriterien erfüllt. Ein solcher Lauf wird normal abgeschlossen; die Registerkarte „Ausgabedaten“ zeigt weiterhin die Zusammenfassung an.

### Berichtszustellung

Berichtsdateien werden nur generiert, wenn eine Zustellmethode über die **Berichtszustellung** Option (E-Mail und/oder Downloadlink) ausgewählt wird. Mit *Nur Ausgabedaten* ausgewählt, werden die Ergebnisse direkt im Tab „Output Data“ des RealmJoin-Portals gelesen, wo jede Tabelle auch nach Excel exportiert werden kann. E-Mail-Zustellung und das Erstellen eines Download-Links sind unabhängig und können kombiniert werden.

Für den Downloadlink werden die Berichtsdateien in den in den Azure Storage Account hochgeladen, der in den `RJReport.StorageAccount.*` Tenant-Einstellungen konfiguriert ist, und zeitlich begrenzte SAS-Downloadlinks werden zurückgegeben. Der Speicher-Upload authentifiziert sich mit der verwalteten Identität des Automation-Kontos; diese Identität benötigt die **Reader and Data Access** RBAC-Rolle auf dem Ziel-Storage Account (dies ist eine Azure-RBAC-Zuweisung, keine Graph-Anwendungsberechtigung).

Zeitpläne, die vor der **Berichtszustellung** Option existierte, senden weiterhin ihre E-Mail: Ein gespeicherter Empfänger allein aktiviert die E-Mail für sie weiterhin. Wenn ein solcher Zeitplan zum Bearbeiten geöffnet wird, zeigt die Option *Nur Ausgabedaten*an; wählen Sie die Zustellung vor dem Speichern erneut aus, andernfalls sendet der Zeitplan den Bericht nicht mehr.

### Konfiguration für den E-Mail-Versand

Das Senden eines Berichts per E-Mail ist optional und erfolgt nur, wenn *Den Bericht auch per E-Mail senden* oder *Den Bericht auch per E-Mail senden & Downloadlink* als Berichtsversand ausgewählt ist; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus dem `RJReport.EmailSender` Mandanteneinstellung bezogen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph-API zu senden, müssen Sie eine vorhandene E-Mail-Adresse in der Runbook-Anpassung konfigurieren.

Siehe die [RealmJoin Report Settings Dokumentation](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details zu allen verfügbaren Einstellungen.

#### E-Mail-Branding

Die Bericht-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Mandanteneinstellungen:

* **Kopf- und Fußzeilenbild** - öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Fußzeilenlink** - Ziel des Fußzeilenbilds
* **Akzent- und Textfarbe** - 6-stellige Hexwerte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert die Berichts-E-Mail nie - stattdessen wird der entsprechende Standardwert verwendet.

Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Speicherort

Organisation → Sicherheit → Bericht zu EPM-Elevation-Anfragen (geplant)

**Voller Runbook-Name**

rjgit-org\_security\_report-EPM-elevation-requests\_scheduled

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 1.4.0                                                                                                              |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planbar              | ja                                                                                                                 |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementConfiguration.Read.All
    * *Fragt Endpoint Privilege Management elevationRequests nach Status und Erstellungsdatum ab, um den Bericht zu erstellen*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die Bericht-E-Mail mit CSV/XLSX-Anhängen über Send-RjRbReportEmail, wenn die E-Mail-Zustellung ausgewählt ist*
  * Organization.Read.All *(optional — Funktion: E-Mail-Bericht)*
    * *Liest den Anzeigenamen und die ID des Tenant für den E-Mail-Betreff, den E-Mail-Text und die Namen der Berichtsdateien*

#### Hinweise zu Berechtigungen

Azure Storage Account: Rolle 'Reader and Data Access' für die verwaltete Identität des Automation-Kontos auf dem Ziel-Storage Account - der Upload ruft die Kontoschlüssel über listKeys ab (nur für die Downloadlink-Optionen erforderlich)

### Parameter

#### IncludeApproved

Enthält Anfragen, die ein Administrator genehmigt hat.

| Eigenschaft           | Wert                             |
| --------------------- | -------------------------------- |
| Erforderlich          | falsch                           |
| Standardwert          | Wahr                             |
| Typ                   | Boolesch                         |
| Anzeigename im Portal | Genehmigte Anfragen einbeziehen? |

#### IncludeDenied

Enthält Anfragen, die ein Administrator abgelehnt hat.

| Eigenschaft           | Wert                             |
| --------------------- | -------------------------------- |
| Erforderlich          | falsch                           |
| Standardwert          | Wahr                             |
| Typ                   | Boolesch                         |
| Anzeigename im Portal | Abgelehnte Anfragen einbeziehen? |

#### IncludeExpired

Enthält Anfragen, die abgelaufen sind, bevor eine Entscheidung getroffen wurde.

| Eigenschaft           | Wert                              |
| --------------------- | --------------------------------- |
| Erforderlich          | falsch                            |
| Standardwert          | Wahr                              |
| Typ                   | Boolesch                          |
| Anzeigename im Portal | Abgelaufene Anfragen einbeziehen? |

#### IncludeRevoked

Enthält Anfragen, deren Genehmigung später widerrufen wurde.

| Eigenschaft           | Wert                              |
| --------------------- | --------------------------------- |
| Erforderlich          | falsch                            |
| Standardwert          | Wahr                              |
| Typ                   | Boolesch                          |
| Anzeigename im Portal | Widerrufene Anfragen einbeziehen? |

#### IncludePending

Enthält Anfragen, die noch auf eine Entscheidung warten.

| Eigenschaft           | Wert                              |
| --------------------- | --------------------------------- |
| Erforderlich          | falsch                            |
| Standardwert          | Falsch                            |
| Typ                   | Boolesch                          |
| Anzeigename im Portal | Ausstehende Anfragen einbeziehen? |

#### IncludeCompleted

Enthält Anfragen, die genehmigt und verwendet wurden.

| Eigenschaft           | Wert                                 |
| --------------------- | ------------------------------------ |
| Erforderlich          | falsch                               |
| Standardwert          | Falsch                               |
| Typ                   | Boolesch                             |
| Anzeigename im Portal | Abgeschlossene Anfragen einbeziehen? |

#### MaxAgeInDays

Es werden nur Anfragen gemeldet, die innerhalb dieser Anzahl von Tagen erstellt wurden. Intune speichert Anfragedetails 30 Tage lang, daher wird ein höherer Wert auf 30 reduziert.

| Eigenschaft           | Wert                      |
| --------------------- | ------------------------- |
| Erforderlich          | falsch                    |
| Standardwert          | 30                        |
| Typ                   | Int32                     |
| Anzeigename im Portal | Erstellt innerhalb (Tage) |

#### SendEmailReport

Sendet den Bericht an die E-Mail-Adresse des Empfängers.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### EmailTo

Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere durch Kommas; jeder Empfänger erhält eine separate E-Mail.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Empfänger-E-Mail-Adresse(n)                     |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### EmailFrom

Absenderadresse der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.EmailSender übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingHeaderImageUrl

Kopfzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Kopfbereich verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterImageUrl

Fußzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird die standardmäßige RealmJoin-Fußzeile verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterLink

Link hinter dem Fußzeilenbild der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingAccentColor

Akzentfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingTextColor

Textfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ReportFileFormat

Liefern Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | CSV & XLSX                                      |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Berichtsdateiformat                             |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

**Portaloptionen**

| Portaloption | Wert       |
| ------------ | ---------- |
| CSV & XLSX   | CSV & XLSX |
| Nur CSV      | Nur CSV    |
| Nur XLSX     | Nur XLSX   |

#### CreateDownloadLink

Lädt den Bericht außerdem hoch und gibt einen Downloadlink zurück, der nach einigen Tagen abläuft.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ContainerName

Speichercontainer, in den die Berichtsdateien hochgeladen werden. Pro Runbook festlegen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | report-epm-elevation-requests                   |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### StorageAccountName

Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | 6                                               |
| Typ                    | Int32                                           |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/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/de/automatisierung/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.