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

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

PowerShell-Module

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

BESCHREIBUNG	Modulname	Link zum PowerShell-Katalog
Rollupmodul für Power BI-Cmdlets	NA
Administratormodul für Power BI-Cmdlets	MicrosoftPowerBIMgmt.Admin Module
Kapazitätsmodul für Power BI-Cmdlets	MicrosoftPowerBIMgmt.Capacities Module
Datenmodul für Power BI-Cmdlets	MicrosoftPowerBIMgmt.Data Module
Profilmodul für Power BI-Cmdlets	MicrosoftPowerBIMgmt.Profile Module
Berichtsmodul für Power BI	MicrosoftPowerBIMgmt.Reports Module
Arbeitsbereichsmodul für Power BI	MicrosoftPowerBIMgmt.Workspaces Module

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 höher auf jeder Betriebssystemplattform, die von PowerShell Core unterstützt wird.

Einrichtung

Die Cmdlets sind im 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 anstelle des Rollup-Moduls einzelne Module (je nach Ihren Bedürfnissen) installieren, z. B. wenn Sie nur das Modul Workspaces wünschen:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Wenn Sie über eine frühere Version verfügen, können Sie auf 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:

• Individual wird verwendet, um auf Entitäten zuzugreifen, die dem 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 Verwaltungs-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) werden die ersten 100 Arbeitsbereiche angezeigt, die dem Benutzer zugewiesen sind:

Get-PowerBIWorkspace

Verwenden Sie den -All Parameter, um alle Arbeitsbereiche anzuzeigen, die 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

Arbeitsbereich aktualisieren

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

Fügen Sie einen Benutzer zu einem bestimmten Arbeitsbereich hinzu:

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 Migrationsstatus des Arbeitsbereichs

Abrufen des Migrationsstatus des Power BI-Arbeitsbereichs:

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

Stellen Sie einen gelöschten Arbeitsbereich wieder her:

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

Wiederherstellen eines verwaisten Arbeitsbereichs

Ein Arbeitsbereich wird verwaist, wenn ihm keine Administratoren zugewiesen 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:

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

Berichte abrufen

Rufen Sie alle Berichte für den Benutzer ab:

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

Holen Sie sich 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

Abrufen von Importen

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 Arbeitsbereich des Benutzers abgelegt. Um in einem anderen Arbeitsbereich zu platzieren, verwenden Sie die -WorkspaceId Parameter oder -Workspace :

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

Exportieren eines Berichts

Exportieren Sie einen Power BI-Bericht in eine PBIX-Datei:

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

Wenn der Arbeitsbereich außerhalb von Mein Arbeitsbereich vorhanden ist, exportieren Sie mit dem WorkspaceId Parameter oder -Workspace :

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

Abrufen von Datensätzen

Abrufen von Power BI-Datasets:

Get-PowerBIDataset

Aktualisieren des Speichermodus für Datasets

Legen Sie Power BI-Dataset so fest, dass Premium-Dateien für den Speichermodus verwendet werden:

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, die in einem Dataset enthalten sind:

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

Aufrufen der Power BI-REST-API

Für Power BI-APIs , für die keine entsprechenden Cmdlets vorhanden sind, können Sie die authentifizierte Sitzung von Connect-PowerBIServiceAccount wiederverwenden, um benutzerdefinierte REST-Anforderungen zu stellen:

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 wie folgt ab:

Get-PowerBIAccessToken -AsString

Behebung von Fehlern

Um weitere Informationen zu einem Fehler zu erhalten, der von den Cmdlets zurückgegeben wird, verwenden Sie Folgendes:

Resolve-PowerBIError -Last

Diese Informationen können beim Öffnen von Supporttickets für Power BI hilfreich sein.

Probleme und Feedback

Wenn Sie Fehler finden oder möchten, dass bestimmte Funktionen für die PowerShell-Cmdlets für Power BI implementiert werden, melden Sie ein Problem.

Wenn Ihr Problem über die PowerShell-Cmdlets hinausgeht, senden Sie Ihr Feedback an die Power BI-Community oder die offizielle Power BI-Supportwebsite .