Microsoft Power BI-cmdlets voor Windows, PowerShell en PowerShell Core

Welkom bij de PowerShell-referentie voor Microsoft Power BI. Hier vindt u resources voor PowerShell-modules die gericht zijn op Power BI.

PowerShell-modulen

Hieronder vindt u een tabel met de Power BI PowerShell-modules die in deze referentie worden behandeld.

Beschrijving	Naam module	Koppeling naar PowerShell-galerij
Samengetelde module voor Power BI-cmdlets	NA
Beheermodule voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Admin Module
Capaciteitenmodule voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Capacities Module
Gegevensmodule voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Data Module
Profielmodule voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Profile Module
Rapportagemodule voor Power BI	MicrosoftPowerBIMgmt.Reports Module
Werkruimtenmodule voor Power BI	MicrosoftPowerBIMgmt.Workspaces Module

Ondersteunde omgevingen en PowerShell-versies

• Windows PowerShell v3.0 en hoger met .NET 4.7.1 of hoger.
• PowerShell Core (v6) en hoger op elk besturingssysteemplatform dat wordt ondersteund door PowerShell Core.

Installatie

De cmdlets zijn beschikbaar in PowerShell Gallery en kunnen worden geïnstalleerd in een PowerShell-sessie met verhoogde bevoegdheid:

Install-Module -Name MicrosoftPowerBIMgmt

Optioneel kunt u individuele modules installeren (op basis van uw behoeften) in plaats van de rollup-module, bijvoorbeeld als u alleen de Workspaces-module wilt:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Als u een eerdere versie hebt, kunt u bijwerken naar de nieuwste versie door het volgende uit te voeren:

Update-Module -Name MicrosoftPowerBIMgmt

Deïnstalleren

Als u alle Power BI PowerShell-cmdlets wilt verwijderen, voert u het volgende uit in een PowerShell-sessie met verhoogde bevoegdheid:

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

Gebruik

Twee bereiken worden ondersteund door cmdlets die communiceren met Power BI-entiteiten:

• Individu wordt gebruikt om toegang te krijgen tot entiteiten die tot de huidige gebruiker behoren.
• Organisatie wordt gebruikt om toegang te krijgen tot entiteiten in het hele bedrijf. Alleen Power BI-tenantbeheerders mogen gebruik maken.

Als de parameter -Scope niet bestaat op de cmdlet, biedt de entiteit geen ondersteuning voor een beheerders-API.

Aanmelden bij Power BI

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

Werkruimten ophalen

Krijg werkruimten voor de gebruiker. Standaard (d.w.z. zonder -First parameter) worden de eerste 100 werkruimten weergegeven die aan de gebruiker zijn toegewezen:

Get-PowerBIWorkspace

Gebruik de -All parameter om alle werkruimten weer te geven die aan de gebruiker zijn toegewezen:

Get-PowerBIWorkspace -All

Als u een tenantbeheerder bent, kunt u alle werkruimten in uw tenant bekijken door het volgende toe te voegen -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Een werkruimte bijwerken

Werk de naam of beschrijving van de werkruimte van een gebruiker bij:

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

Een nieuwe gebruiker toevoegen aan een werkruimte

Een gebruiker toevoegen aan een bepaalde werkruimte:

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

Een gebruiker verwijderen uit een bepaalde werkruimte

De machtigingen van de gebruiker verwijderen uit een bepaalde werkruimte:

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

De migratiestatus van de werkruimte ophalen

De migratiestatus van Power BI-werkruimten ophalen:

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

Een werkruimte herstellen

Verwijderde werkruimten weergeven als tenantbeheerder:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Een verwijderde werkruimte herstellen:

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

Een zwevende werkruimte herstellen

Een werkruimte wordt zwevend wanneer er geen beheerders aan zijn toegewezen. Als u een tenantbeheerder bent, voert u het volgende uit om alle zwevende werkruimten weer te geven:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Gebruik het volgende om dit probleem op te lossen:

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

Rapporten ophalen

Haal alle rapporten op voor de gebruiker:

Get-PowerBIReport

Als u een tenantbeheerder bent, kunt u alle rapporten in uw tenant bekijken met behulp van toewijzing -Scope Organization:

Get-PowerBIReport -Scope Organization

Dashboards ophalen

Dashboards ophalen voor de gebruiker:

Get-PowerBIDashboard

Als u een tenantbeheerder bent, kunt u alle dashboards in uw tenant bekijken door het volgende toe te voegen -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Tegels ophalen

Tegels ophalen in een dashboard:

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

Importimport ophalen

Power BI-importbestanden downloaden:

Get-PowerBIImport

Een rapport maken

Maak een rapport in Power BI door een *.pbix-bestand te uploaden:

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

Het rapport wordt standaard in Mijn werkruimte van de gebruiker geplaatst. Als u de werkruimte in een andere werkruimte wilt plaatsen, gebruikt u de -WorkspaceId parameters of -Workspace :

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

Een rapport exporteren

Exporteer een Power BI-rapport naar het bestand *.pbix:

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

Als de werkruimte buiten Mijn werkruimte bestaat, exporteert u met de WorkspaceId parameter of -Workspace :

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

Gegevenssets ophalen

Power BI-gegevenssets ophalen:

Get-PowerBIDataset

Opslagmodus gegevensset bijwerken

Stel Power BI-gegevensset in op het gebruik van Premium-bestanden voor de opslagmodus:

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

Gegevensbronnen ophalen

Power BI-gegevensbronnen ophalen voor een gegevensset:

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

Tabellen ophalen

Haal Power BI-tabellen op in een gegevensset:

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

De Power BI Rest-API aanroepen

Voor Power BI-API die geen bijbehorende cmdlets bevat, kunt u de geverifieerde sessie opnieuw Connect-PowerBIServiceAccount gebruiken om aangepaste REST-aanvragen te maken:

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)

Als u de geverifieerde sessie buiten PowerShell wilt gebruiken, haalt u het toegangstoken op met behulp van:

Get-PowerBIAccessToken -AsString

Fouten oplossen

Als u meer informatie wilt over een fout die wordt geretourneerd door de cmdlets, gebruikt:

Resolve-PowerBIError -Last

Deze informatie kan nuttig zijn voor het openen van ondersteuningstickets voor Power BI.

Problemen en feedback

Als u bugs vindt of als u wilt dat bepaalde functionaliteit wordt geïmplementeerd voor de PowerShell-cmdlets voor Power BI, dient u een probleem in.

Als uw probleem breder is dan alleen de PowerShell-cmdlets, verzendt u uw feedback naar de Power BI-community of de officiële Power BI-ondersteuningssite .