> 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-report-settings.md). # Paramètres de rapport des runbooks ## Vue d'ensemble Plusieurs Realmjoin Runbooks incluent des fonctionnalités de reporting automatisé pour fournir des rapports, des notifications et des alertes directement aux administrateurs. Selon la configuration, les rapports peuvent être : * **envoyés par e-mail** — à l'aide de l'API Microsoft Graph au nom d'une adresse d'expéditeur configurée * **téléversés vers un Azure Storage Account** — et rendus disponibles sous forme de lien de téléchargement SAS à durée limitée La prise en charge des deux canaux de distribution est la norme prévue pour tous les runbooks de reporting à l'avenir. Tous les runbooks de reporting ne prennent peut-être pas encore en charge les deux canaux, mais l'ensemble des runbooks pris en charge ne cesse de s'agrandir. Les deux canaux peuvent être activés indépendamment ou en combinaison. Tous les paramètres partagés sont configurés une seule fois dans le [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) et s'appliquent automatiquement à tous les runbooks qui utilisent la fonctionnalité correspondante. Les paramètres qui diffèrent d'un runbook à l'autre (comme le nom du conteneur cible) ne font pas partie de cette configuration centralisée et sont définis directement dans le runbook concerné. Les fonctions qui utilisent ces paramètres — [`Send-RjRbReportEmail`](/fr/dev-reference/report-functions/send-rjrbreportemail.md) et [`Publish-RjRbFilesToStorageContainer`](/fr/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — sont fournies par le **RealmJoin.RunbookHelper** module PowerShell. Voir [Fonctions de rapport](/fr/dev-reference/report-functions.md) pour une documentation détaillée sur l'utilisation. ## Distribution par e-mail ### Prérequis Nous recommandons d'utiliser une boîte aux lettres partagée dédiée, par exemple `realmjoin-report@contoso.com`. Cette boîte aux lettres sera utilisée comme adresse d'expéditeur pour tous les rapports. Vous pouvez utiliser une adresse sans réponse, car il n'est pas attendu que les destinataires répondent aux rapports automatisés. ### Configuration Comme décrit en détail dans la [Personnalisation basée sur JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) documentation, accédez à [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) dans le portail RealmJoin (Settings > Runbook Customizations). Dans le `Paramètres` bloc, ajoutez ou modifiez la `RJReport` section pour inclure la `EmailSender` propriété avec l'adresse e-mail d'expéditeur souhaitée : ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` Remplacez `realmjoin-report@contoso.com` par l'adresse réelle de votre boîte aux lettres partagée. ### Informations de contact du Service Desk (facultatif) Pour inclure les informations de contact du Service Desk dans les e-mails de notification, ajoutez les propriétés suivantes à la `RJReport` section : ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789" } } } ``` **Paramètres :** * `ServiceDesk_DisplayName` — Nom d'affichage de votre Service Desk (par ex. « IT Support », « Help Desk ») * `ServiceDesk_EMail` — Adresse e-mail du Service Desk (affichée sous forme de `mailto:` lien) * `ServiceDesk_Phone` — Numéro de téléphone du Service Desk au format international (affiché sous forme de `tel:` lien) Les trois paramètres sont facultatifs. S'ils sont configurés, ils apparaîtront dans le pied de page de l'e-mail sous forme de liens cliquables. ## Distribution vers un Storage Account Les runbooks de reporting qui prennent en charge ce canal de distribution peuvent téléverser leur sortie vers un conteneur Azure Blob Storage. Après un téléversement réussi, le runbook renvoie un lien SAS à durée limitée qui peut être utilisé pour télécharger le fichier directement. Ce canal peut être utilisé indépendamment de la distribution par e-mail ou en complément de celle-ci. ### Prérequis Un Azure Storage Account existant est requis. L'identité managée du compte Automation (ou le Service Principal utilisé par les runbooks) nécessite au minimum **Storage Blob Data Contributor** des autorisations sur le Storage Account ou son groupe de ressources. ### Configuration Accédez à [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) et ajoutez un `StorageAccount` sous-section au `RJReport` bloc : ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` **Paramètres :** | Paramètre | Requis | Par défaut | Description | | -------------------- | ------ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ResourceGroup` | oui | — | Groupe de ressources qui contient le Storage Account | | `StorageAccountName` | oui | — | Nom du Storage Account Azure | | `LinkExpiryDays` | non | `6` | Nombre de jours avant l'expiration du lien de téléchargement SAS généré | | `AddBlobNamePrefix` | non | `true` | Ajoute un horodatage (`yyyyMMdd-HHmmss`) au nom du blob pour éviter les écrasements | | `UseRandomPrefix` | non | `false` | Utilise une chaîne aléatoire alphanumérique de 6 caractères comme préfixe à la place d'un horodatage ; ne s'applique que lorsque `AddBlobNamePrefix` est `true` | > **Remarque :** Les paramètres spécifiques à un runbook individuel — comme le nom du conteneur cible ou un nom de blob personnalisé — sont configurés directement sur ce runbook et ne font délibérément pas partie de cette configuration centralisée. ## Exemple combiné L'extrait suivant montre une `RJReport` configuration complète avec toutes les fonctionnalités activées : ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-report-settings.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.