Azure Automation et Microsoft Graph : construire un reporting Intune exploitable

L’essentiel

Un Automation Account héberge runbooks, modules, variables non secrètes, schedules et jobs. Une Managed Identity lui permet d’obtenir des tokens Entra sans stocker un mot de passe ou un certificat dans le code.

Le Graph PowerShell SDK n’est pas préchargé intégralement. J’importe Microsoft.Graph.Authentication et seulement les modules nécessaires, avec versions validées et compatibilité PowerShell contrôlée.

Pour les rapports Intune asynchrones, le runbook crée un exportJob, attend un état terminal avec backoff, télécharge l’archive temporaire, valide le schéma puis écrit dans un stockage durable protégé.

Un Automation Account héberge runbooks, modules, variables non secrètes, schedules et jobs. Une Managed Identity lui permet d’obtenir des tokens Entra sans stocker un mot de passe ou un certificat dans le code.

Pourquoi cette technologie existe

Le compte Automation définit la région, l’identité, la politique de réseau, les modules et la rétention des jobs. Dev, recette et production sont séparés afin de ne pas tester une permission ou un module sur le traitement quotidien.

La system-assigned Managed Identity convient à un compte unique ; une user-assigned identity facilite une identité stable partagée, mais augmente le rayon d’impact. Les rôles Graph sont accordés au service principal correspondant.

Je définis l’objectif opérationnel avant de choisir le profil ou l’outil. Cette discipline sépare le besoin de sécurité, l’expérience utilisateur, l’autorité de gestion et la preuve attendue. Elle évite aussi qu’un paramètre soit activé uniquement parce qu’il apparaît dans la console.

Je compare toujours l’intention cloud, l’applicabilité, l’état reçu par Windows et le résultat réellement observé. Une affectation réussie, un état vert ou une requête HTTP acceptée ne prouve pas à lui seul que tout le parcours fonctionne.

Pour expliquer « Azure Automation pour le reporting Intune », je commence par le besoin auquel la technologie répond, puis je sépare le plan de contrôle, le transport, les composants locaux, les états persistés et les données de résultat. Cette lecture évite d’attribuer au portail une décision prise par Windows ou à l’agent une limitation du service cloud.

Je distingue les interfaces supportées des détails internes observables. Les journaux, tâches et clés de registre aident à comprendre le fonctionnement, mais ils ne deviennent pas automatiquement des contrats stables sur lesquels bâtir une automatisation durable.

Enfin, je relie la théorie au cycle réel : déclenchement, traitement, résultat, nouvelle évaluation et comportement en cas de dérive. L’objectif est de comprendre ce qui se passe, pas seulement de reproduire une configuration.

Je qualifie la nature de chaque état : intention envoyée, valeur effective, inventaire, conformité, télémétrie ou simple cache d’affichage. Ces données n’ont ni la même fraîcheur ni la même autorité. Un résultat cohérent suppose de connaître qui produit l’information, à quel moment, dans quel contexte et selon quel mécanisme elle revient au service.

Je replace aussi la technologie dans son environnement. Les identités, certificats, licences, services réseau, versions clientes et autres outils de gestion peuvent modifier son comportement sans appartenir directement à son moteur. Cette frontière permet de distinguer une limitation intrinsèque d’une dépendance absente ou d’un conflit d’architecture.

Quand une observation terrain complète la documentation, je la présente comme un indice et non comme une garantie de support. Les noms de tâches, fichiers, événements ou rythmes internes peuvent changer. Je m’appuie sur eux pour expliquer et diagnostiquer, tandis que les décisions de conception reposent sur les interfaces et comportements officiellement documentés.

• À comprendre : comprendre l’architecture, les dépendances et les limites
• À comprendre : mettre en œuvre un pilote mesurable et reproductible
• À comprendre : construire un diagnostic et un rollback utilisables par l’exploitation
• Périmètre étudié : Azure Automation, Microsoft Graph, Intune, Managed Identity
• Périmètre étudié : postes Windows gérés et services Microsoft officiellement documentés
• Périmètre étudié : validation en laboratoire puis pilote représentatif avant généralisation

Architecture, composants et flux de données

Le compte Automation définit la région, l’identité, la politique de réseau, les modules et la rétention des jobs. Dev, recette et production sont séparés afin de ne pas tester une permission ou un module sur le traitement quotidien.

La system-assigned Managed Identity convient à un compte unique ; une user-assigned identity facilite une identité stable partagée, mais augmente le rayon d’impact. Les rôles Graph sont accordés au service principal correspondant.

Les runbooks PowerShell modernes utilisent le runtime supporté par les modules choisis. Je verrouille les versions de Microsoft.Graph.Authentication et des sous-modules plutôt que d’importer aveuglément tout le SDK.

Prérequis, compatibilité et limites de support

Je sépare les prérequis nécessaires à l’existence de la fonction de ceux qui ne concernent qu’un scénario d’administration. La présence d’une option dans une console ne prouve ni la prise en charge de la version cliente, ni l’éligibilité de la licence.

Les builds, éditions, rôles, dépendances réseau et contextes d’exécution doivent être confirmés avant d’interpréter un comportement. Les éléments internes observés mais non documentés comme interfaces publiques sont explicitement traités comme tels.

• abonnement Azure et Automation Account
• Managed Identity dédiée
• permissions Graph minimales
• modules versionnés
• stockage chiffré et rétention
• schedule UTC
• alertes et runbook de reprise

Cycle de fonctionnement, étape par étape

Cette séquence décrit ce que font les différents composants, depuis le déclenchement jusqu’au résultat. Elle sert de modèle mental : selon le scénario, certaines étapes peuvent être asynchrones ou exécutées dans un autre contexte.

Je distingue l’action demandée, son transport, son traitement local et son accusé de résultat. Cette distinction explique pourquoi deux écrans peuvent afficher temporairement des états différents sans qu’il y ait nécessairement une panne.

Fonctionnement détaillé et responsabilités

Le compte Automation définit la région, l’identité, la politique de réseau, les modules et la rétention des jobs. Dev, recette et production sont séparés afin de ne pas tester une permission ou un module sur le traitement quotidien.

La system-assigned Managed Identity convient à un compte unique ; une user-assigned identity facilite une identité stable partagée, mais augmente le rayon d’impact. Les rôles Graph sont accordés au service principal correspondant.

Les runbooks PowerShell modernes utilisent le runtime supporté par les modules choisis. Je verrouille les versions de Microsoft.Graph.Authentication et des sous-modules plutôt que d’importer aveuglément tout le SDK.

• abonnement Azure et Automation Account
• Managed Identity dédiée
• permissions Graph minimales
• modules versionnés

Configuration, exploitation et cas limites

Un schedule déclenche le runbook selon UTC. Les paramètres obligatoires, valeurs par défaut et fuseau sont documentés ; un décalage heure d’été ne doit pas déplacer silencieusement la fenêtre de données.

Le runbook est idempotent : un identifiant de période et de rapport permet de détecter un fichier déjà validé. Une reprise ne duplique pas les lignes et ne remplace pas une archive saine par un job incomplet.

Graph peut retourner 429 avec Retry-After, 5xx temporaire ou un job encore inProgress. Le runbook applique backoff, jitter, limite globale de durée et sortie distincte pour erreur fonctionnelle et erreur transitoire.

• Valider archive, hash et schéma
• Tester 429, reprise et doublon
• Activer schedule et alertes

Interpréter les résultats sans raccourci

Le stockage sépare zone brute immuable, données normalisées et publication. Les URLs signées et tokens ne sont jamais conservés ; les fichiers possèdent hash, taille, schéma, horodatage UTC et corrélation.

La supervision alerte sur absence de succès, durée anormale, volume nul, schéma modifié, throttling persistant et échec d’écriture. Un job Completed sans fichier valide reste un échec opérationnel.

Le rollback désactive le schedule, conserve les données validées et repasse au runbook précédent. Les permissions nouvelles sont révoquées après vérification qu’aucun autre workload ne partage l’identité.

Je distingue une donnée de configuration, une donnée d’inventaire et une preuve d’exécution. La première décrit ce qui devrait arriver, la deuxième décrit un état observé à un instant donné et la troisième montre ce qu’un composant a réellement tenté. Leur horodatage et leur contexte doivent converger avant toute conclusion.

Je documente les états non applicable, pending, conflict, error et success séparément. Un poste absent d’un rapport n’est pas nécessairement sain ou en échec : il peut être hors ligne, non éligible, non ciblé, en retard de télémétrie ou exclu par la politique de collecte.

Pilote, généralisation et maintien en conditions opérationnelles

Le pilote couvre plusieurs modèles matériels, versions de Windows, profils réseau, populations utilisateur et exceptions métier. Je conserve une cohorte témoin afin de différencier l’effet du changement d’une évolution globale du service, d’une mise à jour applicative ou d’un incident réseau.

Les critères GO sont définis avant le début : couverture, taux de succès, délai de convergence, incidents, tickets support, régressions et temps de rollback. Une moyenne satisfaisante ne masque pas un sous-groupe en échec ; les résultats sont donc segmentés par version, modèle, site et mode de gestion.

Les cas négatifs sont testés volontairement : appareil hors ligne, licence absente, identité non éligible, règle non applicable, réseau filtré et retour arrière. Un design exploitable doit échouer de manière visible, sûre et compréhensible pour le support.

Après généralisation, je programme une revue des exceptions, des permissions, des versions de profil et des dépendances. Le service cloud et Windows évoluent ; une décision correcte aujourd’hui doit rester traçable et être revalidée lorsqu’un prérequis ou une interface change.

Interfaces d’observation, commandes et exemples

Les commandes illustrent les objets et états décrits dans l’article. Les exemples de diagnostic restent non testés, en niveau 1 et sans modification volontaire. Ils servent à comprendre les données disponibles, pas à industrialiser une collecte.

Une automatisation durable doit employer une API ou une interface officiellement supportée. Une clé de registre, un fichier ou une tâche interne peut évoluer avec Windows, l’agent ou le service.

# Exemple pédagogique non testé — niveau 1
$ErrorActionPreference = 'Stop'
try {
  Connect-MgGraph -Identity -NoWelcome
  $context = Get-MgContext
  $response = Invoke-MgGraphRequest -Method GET -Uri 'https://graph.microsoft.com/v1.0/deviceManagement/managedDevices?%24top=1&%24select=id,deviceName,lastSyncDateTime'
  [pscustomobject]@{TenantId=$context.TenantId;Count=$response.value.Count;CheckedAt=(Get-Date).ToUniversalTime()}
} catch { Write-Error "Test du runbook impossible : $($_.Exception.Message)"; exit 1 }
finally { Disconnect-MgGraph -ErrorAction SilentlyContinue }

Observabilité : où lire l’état réel

Je construis une chronologie unique avec l’heure de la demande, le check-in, l’événement local, la décision du composant et la remontée dans le portail. Je conserve UTC et heure locale, mais j’anonymise UPN, DeviceId, TenantId, noms internes, certificats, adresses et contenus métiers avant partage.

La collecte initiale reste en lecture seule. Je ne vide pas un cache, ne supprime pas une clé, ne réinitialise pas un agent et ne force pas un enrôlement avant d’avoir capturé les preuves. Ces actions changent l’état et peuvent rendre la cause première impossible à démontrer.

Les scripts publiés ici sont des exemples pédagogiques non testés de niveau 1. Toute remédiation réelle doit être au minimum de niveau 2, proposer une simulation, limiter sa cible, expliquer son impact et restaurer l’état précédent. Les opérations privilégiées ou à grande échelle exigent un niveau supérieur et une approbation formelle.

• Créer l’environnement Automation de recette.
• Activer l’identité et accorder une lecture minimale.
• Importer les modules figés.
• Exécuter un runbook manuel borné.
• Valider archive, hash et schéma
• Tester 429, reprise et doublon
• Activer schedule et alertes

Validation du modèle et cas d’usage

Je vérifie le modèle sur un appareil représentatif en reliant la configuration du service, l’état reçu, le traitement local et la donnée remontée. L’objectif n’est pas de certifier la production, mais de confirmer que l’explication décrit bien le comportement observé.

Un cas d’usage est retenu lorsque la technologie répond au besoin sans ajouter une autorité concurrente, une dépendance non maîtrisée ou un niveau d’opacité incompatible avec l’exploitation.

• Créer l’environnement Automation de recette.
• Activer l’identité et accorder une lecture minimale.
• Importer les modules figés.
• Exécuter un runbook manuel borné.
• Valider archive, hash et schéma
• Tester 429, reprise et doublon
• Activer schedule et alertes

Limites, modes de panne et lecture des erreurs

Cette matrice relie les limites du modèle aux symptômes observables. Elle ne transforme pas une technologie en article de dépannage : elle montre où le fonctionnement normal peut diverger et quelles preuves permettent de comprendre cette divergence.

Une erreur isolée doit être replacée dans sa phase et son contexte. Je privilégie les résultats documentés du service et du client avant les détails d’implémentation susceptibles de changer.

Adoption progressive, réversibilité et vigilance

Pour introduire la technologie, je commence par un scénario borné, des appareils pilotes et des critères d’observation définis. L’adoption progresse uniquement si les dépendances, la supervision et les responsabilités de support sont comprises.

Le retour arrière dépend souvent de la propriété de la ressource et du cycle de synchronisation. Je le teste avant généralisation et je ne déduis jamais la réversibilité de la seule disparition d’un profil dans le portail.

• Réversibilité : désactiver le schedule sans supprimer les jobs
• Réversibilité : réactiver la version précédente du runbook et des modules
• Réversibilité : révoquer les nouveaux rôles après vérification des dépendances
• Limite ou vigilance : MFA interdit le compte utilisateur non interactif
• Limite ou vigilance : verrouiller les modules
• Limite ou vigilance : ne pas loguer les URLs signées
• Limite ou vigilance : distinguer job Azure réussi et donnée valide