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

# Rapport planifié des demandes d'élévation EPM

Rapporter les demandes d'élévation EPM par statut et ancienneté

{% hint style="info" %}
Il s'agit d'un runbook planifié. Il est conçu pour s'exécuter selon une planification récurrente plutôt que d'être déclenché pour un seul objet. Voir [Planification](https://docs.realmjoin.com/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook.
{% endhint %}

### Description

Collecte les demandes d’élévation Endpoint Privilege Management depuis Intune, filtrées par statut et par ancienneté de création. Les demandes sont listées par statut avec un résumé des nombres. Intune conserve les détails des demandes pendant 30 jours, donc les demandes plus anciennes ne peuvent pas être signalées. Le rapport peut être envoyé par e-mail ou fourni sous forme de lien de téléchargement.

### Objectif et cas d’utilisation

* Rapport régulier des activités Endpoint Privilege Management (EPM)
* Piste d’audit pour les demandes d’élévation approuvées et refusées
* Analyse des demandes expirées pour identifier les goulets d’étranglement du processus
* Identification des applications fréquemment demandées pour les règles d’élévation automatique

Une planification mensuelle est recommandée.

### Types de statut

* **En attente :** attend la décision d’un administrateur (utilisez **Surveiller les demandes EPM en attente** pour les alertes urgentes)
* **Approuvée :** un administrateur a approuvé la demande, l’utilisateur peut poursuivre avec l’élévation
* **Refusée :** un administrateur a rejeté la demande en raison de préoccupations liées à la sécurité ou à la stratégie
* **Expirée :** la demande a expiré avant qu’un administrateur ne l’examine, ce qui peut indiquer des temps de réponse lents
* **Révoquée :** une élévation précédemment approuvée a ensuite été révoquée par un administrateur
* **Terminée :** l’utilisateur a exécuté avec succès l’application à privilèges élevés après approbation

### Rétention des données et plages de temps

* Intune conserve les détails des demandes EPM pendant 30 jours après leur création.
* Pour une analyse à long terme, archivez les exports CSV en dehors d’Intune.
* Le filtre par défaut couvre les états Approuvée, Refusée, Expirée et Révoquée sur les 30 derniers jours.

### Fichiers de sortie et de rapport

* L’onglet Données de sortie de l’exécution affiche un *Résumé* tableau avec les nombres et un tableau par statut sélectionné (par exemple *Demandes approuvées*), la demande la plus ancienne en premier.
* Les fichiers de rapport contiennent chaque demande correspondante avec tous les détails : horodatages, utilisateurs, appareils, applications, justifications et hachages de fichiers. Ils sont générés en CSV et/ou en Excel (xlsx), selon le format de fichier de rapport sélectionné.
* Les e-mails sont envoyés individuellement à chaque destinataire pour des raisons de confidentialité.
* Aucun e-mail n’est envoyé et aucun fichier n’est créé lorsqu’aucune demande ne correspond aux critères de filtre. Une telle exécution se termine normalement ; l’onglet Données de sortie affiche toujours le résumé.

### Livraison du rapport

Les fichiers du rapport ne sont générés que lorsqu'une méthode de livraison est sélectionnée via l' **Livraison du rapport** option (e-mail et/ou lien de téléchargement). Avec *Données de sortie uniquement* sélectionnés, les résultats sont lus directement dans l'onglet Données de sortie du portail RealmJoin, où chaque tableau peut également être exporté vers Excel. L'envoi par e-mail et la génération du lien de téléchargement sont indépendants et peuvent être combinés.

Pour le lien de téléchargement, les fichiers du rapport sont téléversés vers le Storage Account Azure configuré dans les `RJReport.StorageAccount.*` paramètres du Tenant, et des liens de téléchargement SAS à durée limitée sont renvoyés. Le téléversement vers le Storage Account s'authentifie avec l'identité managée du compte Automation ; cette identité a besoin du **Lecture et accès aux données** rôle RBAC sur le Storage Account cible (il s'agit d'une attribution Azure RBAC, et non d'une autorisation d'application Graph).

Les planifications créées avant que l' **Livraison du rapport** option n'existait continuent d'envoyer leur e-mail : un destinataire enregistré suffit toujours à activer l'e-mail pour elles. Lorsqu'une telle planification est ouverte en modification, l'option affiche *Données de sortie uniquement*; sélectionnez à nouveau la livraison avant d'enregistrer, sinon la planification cesse d'envoyer le rapport.

### Configuration relative à l'envoi d'e-mails

L'envoi d'un rapport par e-mail est facultatif et ne se produit que lorsque *Envoyer également le rapport par e-mail* ou *Envoyer également par e-mail et lien de téléchargement* est sélectionné comme mode de livraison du rapport ; un destinataire est alors requis. L’adresse de l’expéditeur est prise à partir de `RJReport.EmailSender` du Tenant.

Ce runbook envoie des e-mails en utilisant l'API Microsoft Graph. Pour envoyer des e-mails via l'API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Voir la [documentation RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails sur tous les paramètres disponibles.

#### Branding des e-mails

L'e-mail du rapport tient compte des paramètres facultatifs du `RJReport.Branding.*` Tenant :

* **Image d'en-tête et de pied de page** - URL HTTPS publiques, PNG/JPEG/GIF, max. 200 Ko chacune
* **Lien du pied de page** - cible de l'image de pied de page
* **Couleur d'accent et de texte** - valeurs hexadécimales à 6 chiffres, par ex. `#0052cc`

Lorsque ces paramètres ne sont pas configurés, les graphiques et les couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur invalide, n'empêche jamais l'envoi du rapport par e-mail - la valeur par défaut correspondante est utilisée à la place.

Instructions de configuration et exigences relatives aux images : [Branding des e-mails](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Emplacement

Organisation → Sécurité → Rapport des demandes d’élévation EPM (planifié)

**Nom complet du runbook**

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

### Détails

| Propriété      | Valeur                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version        | 1.5.0                                                                                                              |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planifiable    | oui                                                                                                                |

### Autorisations

#### Autorisations d'application

* **Type**: Microsoft Graph
  * DeviceManagementConfiguration.Read.All
    * *Interroge les elevationRequests Endpoint Privilege Management selon le statut et la date de création pour générer le rapport*
  * Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Envoie l’e-mail de rapport avec des pièces jointes CSV/XLSX via Send-RjRbReportEmail lorsque la livraison par e-mail est sélectionnée*
  * Organization.Read.All *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Lit le nom d’affichage du locataire et l’ID pour l’objet de l’e-mail, le corps de l’e-mail et les noms de fichiers du rapport*

#### Remarques sur les autorisations

Azure Storage Account : rôle « Reader and Data Access » pour l'identité managée du compte Automation sur le Storage Account cible - le téléversement récupère les clés du compte via listKeys (uniquement requis pour les options de lien de téléchargement)

### Paramètres

#### IncludeApproved

Inclut les demandes approuvées par un administrateur.

| Propriété                  | Valeur                            |
| -------------------------- | --------------------------------- |
| Obligatoire                | false                             |
| Valeur par défaut          | Vrai                              |
| Type                       | Booléen                           |
| Nom d'affichage du portail | Inclure les demandes approuvées ? |

#### IncludeDenied

Inclut les demandes rejetées par un administrateur.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | false                           |
| Valeur par défaut          | Vrai                            |
| Type                       | Booléen                         |
| Nom d'affichage du portail | Inclure les demandes refusées ? |

#### IncludeExpired

Inclut les demandes qui ont expiré avant qu’une décision soit prise.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | false                           |
| Valeur par défaut          | Vrai                            |
| Type                       | Booléen                         |
| Nom d'affichage du portail | Inclure les demandes expirées ? |

#### IncludeRevoked

Inclut les demandes dont l’approbation a ensuite été retirée.

| Propriété                  | Valeur                           |
| -------------------------- | -------------------------------- |
| Obligatoire                | false                            |
| Valeur par défaut          | Vrai                             |
| Type                       | Booléen                          |
| Nom d'affichage du portail | Inclure les demandes révoquées ? |

#### IncludePending

Inclut les demandes qui attendent encore une décision.

| Propriété                  | Valeur                            |
| -------------------------- | --------------------------------- |
| Obligatoire                | false                             |
| Valeur par défaut          | Faux                              |
| Type                       | Booléen                           |
| Nom d'affichage du portail | Inclure les demandes en attente ? |

#### IncludeCompleted

Inclut les demandes qui ont été approuvées et utilisées.

| Propriété                  | Valeur                           |
| -------------------------- | -------------------------------- |
| Obligatoire                | false                            |
| Valeur par défaut          | Faux                             |
| Type                       | Booléen                          |
| Nom d'affichage du portail | Inclure les demandes terminées ? |

#### MaxAgeInDays

Seules les demandes créées au cours de ce nombre de jours sont signalées. Intune conserve les détails des demandes pendant 30 jours, donc une valeur plus élevée est réduite à 30.

| Propriété                  | Valeur                |
| -------------------------- | --------------------- |
| Obligatoire                | false                 |
| Valeur par défaut          | 30                    |
| Type                       | Int32                 |
| Nom d'affichage du portail | Créé dans les (jours) |

#### SendEmailReport

Envoyer le rapport à l'adresse e-mail du destinataire.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### EmailTo

Envoyez le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail distinct.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | false                                              |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d'affichage du portail | Adresse(s) e-mail du destinataire                  |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### EmailFrom

Adresse de l'expéditeur de l'e-mail du rapport. Prise du paramètre Tenant RJReport.EmailSender.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingHeaderImageUrl

Image d'en-tête de l'e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, max 200 Ko). Prise du paramètre Tenant RJReport.Branding.HeaderImageUrl ; l'en-tête RealmJoin par défaut est utilisé lorsqu'il est vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterImageUrl

Image de pied de page de l'e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, max 200 Ko). Prise du paramètre Tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé lorsqu'il est vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterLink

Lien derrière l'image de pied de page de l'e-mail du rapport. Pris du paramètre Tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé lorsqu'il est vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingAccentColor

Couleur d'accent de l'e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise du paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée lorsqu'elle est vide ou invalide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingTextColor

Couleur du texte de l'e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise du paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée lorsqu'elle est vide ou invalide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ReportFileFormat

Remettez le rapport au format CSV, sous forme de classeur Excel, ou les deux.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | false                                              |
| Valeur par défaut          | CSV et XLSX                                        |
| Type                       | Chaîne                                             |
| Nom d'affichage du portail | Format du fichier de rapport                       |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

**Options du portail**

| Option du portail | Valeur          |
| ----------------- | --------------- |
| CSV et XLSX       | CSV et XLSX     |
| CSV uniquement    | CSV uniquement  |
| XLSX uniquement   | XLSX uniquement |

#### CreateDownloadLink

Télécharge aussi le rapport et renvoie un lien de téléchargement qui expire après quelques jours.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ContainerName

Conteneur de stockage vers lequel les fichiers du rapport sont téléversés. À définir par runbook.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | report-epm-elevation-requests                      |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ResourceGroupName

Groupe de ressources du Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.ResourceGroup.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### StorageAccountName

Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.StorageAccountName.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### SubscriptionId

ID d'abonnement du Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.SubscriptionId ; lorsque vide, l'abonnement sur lequel l'identité managée se connecte est utilisé.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### LinkExpiryDays

Nombre de jours pendant lesquels un lien de téléchargement reste valide. Pris à partir du paramètre du locataire RJReport.StorageAccount.LinkExpiryDays.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | 6                                                  |
| Type                   | Int32                                              |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

[Retour à l'aperçu de la référence du runbook](https://docs.realmjoin.com/fr/automatisation/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/fr/automatisation/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.
