Exporter des événements Power BI avec PowerShell

Téléchargez gratuitement en PDF mon support de cours pour apprendre à créer des rapports avec Power BI Desktop. Il comprend l’exposé des notions (185 pages) et plus de 50 travaux pratiques corrigés de Power BI.

Avant de débuter cet exercice, les manipulations de Activer l’audit Microsoft 365 doivent être réalisées depuis au moins 48 heures.

Cet exemple vous demande d’exporter des événements Power BI en utilisant des cmdlets PowerShell.

En particulier la cmdlet PowerShell qui récupère les événements d’activité d’audit Power BI :

Get-PowerBIActivityEvent

Une fois que les événements d’activité sont récupérés, vous verrez comment les exporter sur l’affichage.

Pour des raisons pratiques, ces manipulations sont faites via PowerShell. Toutefois, si vous êtes plus à l’aise avec l’interface graphique, vous pouvez aussi les faire via cette adresse :

https://compliance.microsoft.com/auditlogsearch

Malgré tout, nous vous conseillons d’utiliser de préférence PowerShell.

Cet article fait partie d’une série d’articles sur l’Administration de Power BI Service :

1. Créer une stratégie de publication d’étiquettes
2. Personnaliser le logo et l’image de Power BI Service
3. Déployer un visuel d’organisation pour Power BI
4. Consultation des métriques d’utilisation de Power BI Service
5. Consultation des métriques de protection
6. Exporter des événements Power BI avec PowerShell
7. Exporter des événements Power BI via API REST
8. Manipuler les espaces de travail Power BI via API REST
9. Restaurer un espace de travail Power BI en PowerShell

Export avec Get-PowerBIActivityEvent

La cmdlet PowerShell Get-PowerBIActivityEvent permet d’exporter les événements d’activité des journaux d’audit.

Elle accepte en paramètres une date de début et une date de fin qui doivent faire référence à la même valeur de date, car vous ne pouvez récupérer les données d’activité que pour un jour à la fois.

L’exemple suivant montre comment exporter toutes les activités Power BI.

Par ailleurs, la commande convertit les résultats de JSON en objets .NET pour un accès direct aux propriétés d’activité individuelles.

Toutes les commandes PowerShell doivent être exécutées dans une fenêtre PowerShell avec élévation de privilèges. C’est-à-dire une fenêtre PowerShell ouverte en sélectionnant Exécuter en tant qu’administrateur.

Pour permettre l’exécution des futurs scripts PowerShell, exécutez la cmdlet suivante :

Set-ExecutionPolicy RemoteSigned

Pour installer la dernière version du module Power BI, exécutez la commande PowerShell suivante, dans l’invite de commandes précédente :

Install-Module -Name MicrosoftPowerBIMgmt

Pour se connecter, exécutez la cmdlet suivante :

Connect-PowerBIServiceAccount

Les alias de Connect-PowerBIServiceAccount sont Login-PowerBIServiceAccount ou Login-PowerBI. Si vous préférez, vous pouvez utiliser un de ses alias.

Pour récupérer les journaux d’audit de Power BI, exécutez la commande PowerShell suivante :

$evenements = Get-PowerBIActivityEvent -StartDateTime <date début> -EndDateTime <date fin> | ConvertFrom-Json

Spécifiez une date de début et une date de fin où des activités ont été enregistrées.

Par exemple :

$evenements = Get-PowerBIActivityEvent -StartDateTime '2022-08-21T00:00:00' -EndDateTime '2022-08-21T23:59:59' | ConvertFrom-Json

N’oubliez pas T00:00:00 dans StartDateTime, ni T23:59:59 dans EndDateTime.

Pour connaître le nombre d’événements récupérés, exécutez la cmdlet suivante :

$evenements.Count

Pour afficher le premier événement, exécutez la cmdlet suivante :

$evenements[0]

Pour vous aider, regardez la copie d’écran ci-dessous.

Une fois que vous savez exporter des événements des journaux d’audit, libre à vous d’utiliser cette technique comme bon vous semble : rechercher des événements, examiner un événement précis ou une série d’événements précis, importer l’export dans une base de données, etc.

Résumé

Avec ces manipulations, vous avez découvert que vous pouviez vous connecter à l’aide de la cmdlet Login-PowerBI ou un de ces alias : Login-PowerBIServiceAccount, Connect-PowerBIServiceAccount.

Vous avez aussi appris la cmdlet Get-PowerBIActivityEvent pour récupérer les événements d’activité d’audit Power BI. Cette commande nécessite que l’utilisateur soit un administrateur Power BI.

L’export à l’écran a été fait après la transformation opérée par la cmdlet ConvertFrom-Json. Cette commande convertit une chaîne au format JSON en une table de hachage.