Paramètres de rapport des runbooks

Configurer des paramètres centralisés de remise par e-mail et de stockage pour les runbooks de reporting.

Aperçu

Plusieurs runbooks RealmJoin incluent des capacité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 mis à disposition sous la forme d'un lien de téléchargement SAS à durée limitée

La prise en charge des deux canaux de distribution est la norme visée pour tous les runbooks de reporting à l'avenir. Tous les runbooks de reporting ne prennent pas encore forcément en charge les deux canaux, mais l'ensemble des runbooks pris en charge ne cesse de croître. 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 Personnalisation des runbooks RealmJoin et s'appliquent automatiquement à tous les runbooks qui utilisent la fonctionnalité correspondante. Les paramètres qui diffèrent selon le runbook (comme le nom du conteneur cible) ne font pas partie de cette configuration centrale et sont définis directement dans le runbook concerné.

Les fonctions qui consomment ces paramètres — Send-RjRbReportEmail et Publish-RjRbFilesToStorageContainer — sont fournies par le module PowerShell RealmJoin.RunbookHelper . Voir Fonctions de rapport 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, telle que [e-mail]. 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 les destinataires ne sont pas censés répondre aux rapports automatisés.

Configuration

Comme décrit en détail dans la documentation de Personnalisation basée sur JSON , accédez à Personnalisation des runbooks RealmJoin dans le portail RealmJoin (Settings > Runbook Customizations).

Dans le bloc Settings , ajoutez ou modifiez la section RJReport pour inclure la propriété EmailSender avec l'adresse e-mail d'expéditeur souhaitée :

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[e-mail]"
        }
    }
}

Remplacez [e-mail] par l'adresse réelle de votre boîte aux lettres partagée.

Informations de contact du Service Desk (facultatif)

Cette configuration centrale fournit uniquement les valeurs unifiées du Service Desk pour tous les runbooks. Le fait que les coordonnées soient réellement incluses dans un e-mail de notification est déterminé par le runbook concerné lui-même — seuls les runbooks qui implémentent les paramètres Service Desk correspondants (par ex. ServiceDeskDisplayName, ServiceDeskPortalUrl) lisent ces valeurs et les affichent dans leurs e-mails.

Pour fournir les informations de contact du Service Desk pour ces runbooks, ajoutez les propriétés suivantes à la RJReport section :

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[e-mail]",
            "ServiceDesk_DisplayName": "IT Service Desk",
            "ServiceDesk_EMail": "[e-mail]",
            "ServiceDesk_Phone": "[phone]",
            "ServiceDesk_PortalUrl": "https://servicedesk.domain.com"
        }
    }
}

Paramètres :

• ServiceDesk_DisplayName — Nom d'affichage de votre Service Desk (p. ex. "IT Support", "Help Desk")
• ServiceDesk_EMail — Adresse e-mail du Service Desk (affichée comme un lien cliquable mailto: lien)
• ServiceDesk_Phone — Numéro de téléphone du Service Desk au format international (affiché comme un lien cliquable tel: lien)
• ServiceDesk_PortalUrl — URL du portail ou du site web de votre Service Desk (affichée comme un lien cliquable)

Tous les 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.

Remarque : Certains runbooks acceptent également un lien de ticket par exécution (p. ex. ServiceDeskTicketUrl) pour faire référence au ticket spécifique qui a déclenché la demande. Il s'agit d'un paramètre de runbook, qui ne fait pas partie de cette configuration centrale.

Distribution via Storage Account

Les runbooks de reporting qui prennent en charge ce canal de distribution peuvent téléverser leur sortie dans 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 de l'Automation Account (ou le Service Principal utilisé par les runbooks) nécessite au moins Contributeur aux données Blob Storage des autorisations sur le Storage Account ou son groupe de ressources.

Configuration

Accédez à Personnalisation des runbooks RealmJoin et ajoutez une StorageAccount sous-section au RJReport bloc :

{
    "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 Azure Storage Account
LinkExpiryDays	non	6	Nombre de jours avant l'expiration du lien de téléchargement SAS généré
AddBlobNamePrefix	non	vrai	Préfixe un horodatage (yyyyMMdd-HHmmss) au nom du blob pour éviter les écrasements
UseRandomPrefix	non	faux	Utilise une chaîne aléatoire alphanumérique de 6 caractères comme préfixe à la place d'un horodatage ; s'applique uniquement lorsque AddBlobNamePrefix est vrai

Remarque : Les paramètres spécifiques à un runbook individuel — tels que le nom du conteneur cible ou un nom de blob personnalisé — sont configurés directement dans ce runbook et ne font volontairement pas partie de cette configuration centrale.

Exemple combiné

L'extrait suivant montre une RJReport configuration complète avec toutes les fonctionnalités activées :

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[e-mail]",
            "ServiceDesk_DisplayName": "IT Service Desk",
            "ServiceDesk_EMail": "[e-mail]",
            "ServiceDesk_Phone": "[phone]",
            "ServiceDesk_PortalUrl": "https://servicedesk.domain.com",
            "StorageAccount": {
                "ResourceGroup": "rg-reports",
                "StorageAccountName": "stcontosoreports",
                "LinkExpiryDays": 6,
                "AddBlobNamePrefix": true,
                "UseRandomPrefix": false
            }
        }
    }
}