Microsoft Power BI-Cmdlets für Windows PowerShell und PowerShell Core

  • Artikel

Willkommen bei der PowerShell-Referenz für Microsoft Power BI. Hier finden Sie Ressourcen für PowerShell-Module für Power BI.

PowerShell-Module

Nachfolgend finden Sie eine Tabelle der Power BI PowerShell-Module, die in diesem Verweis behandelt werden.

BESCHREIBUNG Name des Moduls link PowerShell-Katalog
Rollupmodul für Power BI-Cmdlets MicrosoftPowerBIMgmt MicrosoftPowerBIMgmt
Admin Modul für Power BI-Cmdlets MicrosoftPowerBIMgmt.Admin MicrosoftPowerBIMgmt. Admin
Kapazitätsmodul für Power BI-Cmdlets MicrosoftPowerBIMgmt.Capacities MicrosoftPowerBIMgmt.Kapazitäten
Datenmodul für Power BI-Cmdlets MicrosoftPowerBIMgmt.Data MicrosoftPowerBIMgmt.Data
Profilmodul für Power BI-Cmdlets MicrosoftPowerBIMgmt.Profile MicrosoftPowerBIMgmt.Profile
Berichtsmodul für Power BI MicrosoftPowerBIMgmt.Reports MicrosoftPowerBIMgmt.Reports
Arbeitsbereichsmodul für Power BI MicrosoftPowerBIMgmt.Workspaces MicrosoftPowerBIMgmt.Workspaces

Unterstützte Umgebungen und PowerShell-Versionen

  • Windows PowerShell v3.0 und höher mit .NET 4.7.1 oder höher.
  • PowerShell Core (v6) und auf jeder von PowerShell Core unterstützten Betriebssystemplattform.

Installation

Die Cmdlets sind auf PowerShell-Katalog verfügbar und können in einer PowerShell-Sitzung mit erhöhten Rechten installiert werden:

Install-Module -Name MicrosoftPowerBIMgmt

Optional können Sie einzelne Module (basierend auf Ihren Anforderungen) anstelle des Rollupmoduls installieren, z. B. wenn Sie nur das Arbeitsbereichsmodul benötigen:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Wenn Sie über eine frühere Version verfügen, können Sie die neueste Version aktualisieren, indem Sie folgendes ausführen:

Update-Module -Name MicrosoftPowerBIMgmt

Deinstallieren

Wenn Sie alle Power BI PowerShell-Cmdlets deinstallieren möchten, führen Sie folgendes in einer PowerShell-Sitzung mit erhöhten Rechten aus:

Get-Module MicrosoftPowerBIMgmt* -ListAvailable | Uninstall-Module -Force

Verwendung

Zwei Bereiche werden von Cmdlets unterstützt, die mit Power BI-Entitäten interagieren:

  • Einzelbenutzer werden verwendet, um auf Entitäten zuzugreifen, die zum aktuellen Benutzer gehören.
  • Die Organisation wird verwendet, um auf Entitäten im gesamten Unternehmen zuzugreifen. Nur Power BI-Mandantenadministratoren dürfen verwendet werden.

Wenn der Parameter "-Scope" im Cmdlet nicht vorhanden ist, unterstützt die Entität keine Administrative API.

Anmelden bei Power BI

Connect-PowerBIServiceAccount   # or use aliases: Login-PowerBIServiceAccount, Login-PowerBI

Abrufen von Arbeitsbereichen

Rufen Sie Arbeitsbereiche für den Benutzer ab. Standardmäßig (d. h. ohne -First Parameter) wird die ersten 100 Arbeitsbereiche angezeigt, die dem Benutzer zugewiesen sind:

Get-PowerBIWorkspace

Verwenden Sie den Parameter, um alle Arbeitsbereiche anzuzeigen, die -All dem Benutzer zugewiesen sind:

Get-PowerBIWorkspace -All

Wenn Sie ein Mandantenadministrator sind, können Sie alle Arbeitsbereiche in Ihrem Mandanten anzeigen, indem Sie folgendes hinzufügen -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Aktualisieren eines Arbeitsbereichs

Aktualisieren Sie den Namen oder die Beschreibung des Arbeitsbereichs eines Benutzers:

Set-PowerBIWorkspace -Scope Organization -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -Name "Test Name" -Description "Test Description"

Hinzufügen eines neuen Benutzers zu einem Arbeitsbereich

Hinzufügen eines Benutzers zu einem bestimmten Arbeitsbereich:

Add-PowerBIWorkspaceUser -Scope Organization -Id 3244f1c1-01cf-457f-9383-6035e4950fdc -UserEmailAddress john@contoso.com -AccessRight Admin

Entfernen eines Benutzers aus einem bestimmten Arbeitsbereich

Entfernen Sie die Berechtigungen des Benutzers aus einem bestimmten Arbeitsbereich:

Remove-PowerBIWorkspaceUser -Scope Organization -Id 3244f1c1-01cf-457f-9383-6035e4950fdc -UserEmailAddress john@contoso.com

Abrufen des Arbeitsbereichmigrationsstatus

Status der Power BI-Arbeitsbereichmigration abrufen:

Get-PowerBIWorkspaceMigrationStatus -Id 038f9a64-1fcd-42f2-957a-13a63b3d3235

Wiederherstellen eines Arbeitsbereichs

So zeigen Sie gelöschte Arbeitsbereiche als Mandantenadministrator an:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Wiederherstellen eines gelöschten Arbeitsbereichs:

Restore-PowerBIWorkspace -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -RestoredName "TestWorkspace" -AdminEmailAddress "john@contoso.com"

Wiederherstellen eines verwaisten Arbeitsbereichs

Ein Arbeitsbereich wird verwaist, wenn keine zugewiesenen Administratoren vorhanden sind. Wenn Sie ein Mandantenadministrator sind, führen Sie folgendes aus, um alle verwaisten Arbeitsbereiche anzuzeigen:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Um dieses Problem zu beheben, verwenden Sie Folgendes:

Add-PowerBIWorkspaceUser -Scope Organization -Id f2a0fae5-1c37-4ee6-97da-c9d31851fe17 -UserPrincipalName 'john@contoso.com' -AccessRight Admin

Abrufen von Berichten

Abrufen aller Berichte für den Benutzer:

Get-PowerBIReport

Wenn Sie ein Mandantenadministrator sind, können Sie alle Berichte in Ihrem Mandanten anzeigen, indem Sie folgendes zuweisen -Scope Organization:

Get-PowerBIReport -Scope Organization

Abrufen von Dashboards

Abrufen von Dashboards für den Benutzer:

Get-PowerBIDashboard

Wenn Sie ein Mandantenadministrator sind, können Sie alle Dashboards in Ihrem Mandanten anzeigen, indem Sie folgendes hinzufügen -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Abrufen von Kacheln

Abrufen von Kacheln in einem Dashboard:

Get-PowerBITile -DashboardId 9a58d5e5-61bc-447c-86c4-e221128b1c99

Importe abrufen

Abrufen von Power BI-Importen:

Get-PowerBIImport

Erstellen eines Berichts

Erstellen Sie einen Bericht in Power BI, indem Sie eine *.pbix-Datei hochladen:

New-PowerBIReport -Path .\newReport.pbix -Name 'New Report'

Standardmäßig wird der Bericht im "Mein Arbeitsbereich" des Benutzers platziert. Verwenden Sie zum Platzieren in einem anderen Arbeitsbereich die -WorkspaceId folgenden -Workspace Parameter:

New-PowerBIReport -Path .\newReport.pbix -Name 'New Report' -WorkspaceId f95755a1-950c-46bd-a912-5aab4012a06d

Einen Bericht exportieren

Exportieren eines Power BI-Berichts in die Datei *.pbix:

Export-PowerBIReport -Id b48c088c-6f4e-4b7a-b015-d844ab534b2a -OutFile .\exportedReport.pbix

Wenn der Arbeitsbereich außerhalb des Arbeitsbereichs vorhanden ist, exportieren Sie sie mit dem WorkspaceId oder -Workspace dem Parameter:

Export-PowerBIReport -Id b48c088c-6f4e-4b7a-b015-d844ab534b2a -OutFile .\exportedReport.pbix -WorkspaceId 3bdd9735-0ab5-4f21-bd5d-87e7f1d7fb84

Abrufen von Datasets

Abrufen von Power BI-Datasets:

Get-PowerBIDataset

Aktualisieren des Datensatzspeichermodus

Legen Sie power BI-Dataset fest, um Premium-Dateien für den Speichermodus zu verwenden:

Set-PowerBIDataset -Id 038f9a64-1fcd-42f2-957a-13a63b3d3235 -TargetStorageMode PremiumFiles

Abrufen von Datenquellen

Abrufen von Power BI-Datenquellen für ein Dataset:

Get-PowerBIDatasource -DatasetId 65d7d7e5-8af0-4e94-b20b-50a882ae15e1

Tabellen abrufen

Abrufen von Power BI-Tabellen in einem Dataset:

Get-PowerBITable -DatasetId 65d7d7e5-8af0-4e94-b20b-50a882ae15e1

Aufrufen der Power BI-REST-API

Für Power BI-API, die entsprechende Cmdlets fehlen, können Sie die authentifizierte Sitzung wiederverwendenConnect-PowerBIServiceAccount, um benutzerdefinierte REST-Anforderungen zu erstellen:

Invoke-PowerBIRestMethod -Url 'reports/4eb4c303-d5ac-4a2d-bf1e-39b35075d983/Clone' -Method Post -Body ([pscustomobject]@{name='Cloned report'; targetModelId='adf823b5-a0de-4b9f-bcce-b17d774d2961'; targetWorkspaceId='45ee15a7-0e8e-45b0-8111-ea304ada8d7d'} | ConvertTo-Json -Depth 2 -Compress)

Wenn Sie die authentifizierte Sitzung außerhalb von PowerShell verwenden möchten, rufen Sie das Zugriffstoken mithilfe von:

Get-PowerBIAccessToken -AsString

Problembehandlung

Um weitere Informationen zu einem von den Cmdlets zurückgegebenen Fehler abzurufen, verwenden Sie:

Resolve-PowerBIError -Last

Diese Informationen können hilfreich sein, um Supporttickets für Power BI zu öffnen.

Probleme und Feedback

Wenn Sie fehler finden oder bestimmte Funktionen für die PowerShell-Cmdlets für Power BI implementiert haben möchten, geben Sie ein Problem an.

Wenn Ihr Problem breiter als nur die PowerShell-Cmdlets ist, senden Sie Bitte Ihr Feedback an die Power BI-Community oder die offizielle Power BI-Supportwebsite.