TP Exporter des événements avec PowerShell

Export Power BI en PowerShell

par

dans

Cette manipulation vous montre comment faire un export Power BI en PowerShell 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, vous ferez ces manipulations avec 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.

Au préalable, vous devez avoir pris la précaution d’activer l’audit 48 heures avant de faite cette manipulation. Vous trouverez les explications pour activer l’audit dans l’article Audit Microsoft 365.

Enfin, cet article fait partie d’une série d’articles sur l’administration de Power BI Service :

  1. Étiquette de confidentialité Power BI
  2. Logo et image Power BI
  3. Magasin de visuels Power BI
  4. Métriques d’utilisation Power BI
  5. Métriques de protection Power BI
  6. Export Power BI en PowerShell
  7. Export Power BI API REST
  8. Workspace Power BI API REST
  9. Restaurer un workplace en PowerShell

Gardez à l’esprit que l’interface a pu évoluer fortement depuis que cet article a été rédigé.

Préparer l’export Power BI en PowerShell

Premièrement, la cmdlet PowerShell Get-PowerBIActivityEvent permet d’exporter les événements d’activité des journaux d’audit.

Notamment, 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.

Vous devez exécuter toutes les commandes PowerShell 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

Export Power BI en PowerShell avec Get-PowerBIActivityEvent

Ensuite, 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.

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

$evenements.Count

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

$evenements[0]

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

Export Power BI en PowerShell : Script PowerShell pour exporter les événements Power BI
Export Power BI en PowerShell : Script PowerShell pour exporter les événements Power BI

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.

Pour aller plus loin

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.

Commentaires

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *