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 zijn gericht op Power BI.

PowerShell-modules

Hieronder volgt een tabel met de Power BI PowerShell-modules die in deze verwijzing worden behandeld.

Beschrijving Modulenaam PowerShell Gallery koppeling
Rollup-module voor Power BI-cmdlets MicrosoftPowerBIMgmt MicrosoftPowerBIMgmt
Beheer module voor Power BI-cmdlets MicrosoftPowerBIMgmt.Admin MicrosoftPowerBIMgmt. Beheer
Capaciteitsmodule voor Power BI-cmdlets MicrosoftPowerBIMgmt.Capacities MicrosoftPowerBIMgmt.Capacities
Gegevensmodule voor Power BI-cmdlets MicrosoftPowerBIMgmt.Data MicrosoftPowerBIMgmt.Data
Profielmodule voor Power BI-cmdlets MicrosoftPowerBIMgmt.Profile MicrosoftPowerBIMgmt.Profile
Rapportmodule voor Power BI MicrosoftPowerBIMgmt.Reports MicrosoftPowerBIMgmt.Reports
Werkruimtemodule voor Power BI MicrosoftPowerBIMgmt.Workspaces MicrosoftPowerBIMgmt.Workspaces

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 op PowerShell Gallery en kunnen worden geïnstalleerd in een PowerShell-sessie met verhoogde bevoegdheid:

Install-Module -Name MicrosoftPowerBIMgmt

U kunt desgewenst afzonderlijke modules installeren (op basis van uw behoeften) in plaats van de samengetelde module, bijvoorbeeld als u alleen de werkruimtemodule 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

Verwijderen

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

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

  • Afzonderlijk wordt gebruikt voor toegang tot entiteiten die deel uitmaken van de huidige gebruiker.
  • Organisatie wordt gebruikt voor toegang tot entiteiten in het hele bedrijf. Alleen Power BI-tenantbeheerders mogen deze gebruiken.

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

Aanmelden bij Power BI

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

Werkruimten ophalen

Werkruimten voor de gebruiker ophalen. Standaard (d.w.v. 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 zijn toegewezen aan de gebruiker:

Get-PowerBIWorkspace -All

Als u een tenantbeheerder bent, kunt u alle werkruimten in uw tenant weergeven 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

Gebruikersmachtigingen verwijderen uit een bepaalde werkruimte:

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

Migratiestatus van werkruimte ophalen

Migratiestatus van Power BI-werkruimte 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 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 te verhelpen:

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

Rapporten ophalen

Alle rapporten voor de gebruiker ophalen:

Get-PowerBIReport

Als u een tenantbeheerder bent, kunt u alle rapporten in uw tenant weergeven met behulp van het toewijzen van -Scope Organization:

Get-PowerBIReport -Scope Organization

Dashboards ophalen

Dashboards voor de gebruiker ophalen:

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

Importbewerkingen ophalen

Power BI-importbewerkingen ophalen:

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'

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

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

Een rapport exporteren

Een Power BI-rapport exporteren naar *.pbix-bestand:

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

Als de werkruimte zich buiten mijn werkruimte bevindt, exporteert u deze met de WorkspaceId of -Workspace parameter:

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 voor gegevenssets bijwerken

Stel de Power BI-gegevensset in voor het gebruik van Premium Files 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

Power BI-tabellen ophalen in een gegevensset:

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

De Power BI Rest API aanroepen

Voor API van Power BI die geen bijbehorende cmdlets hebben, kunt u de geverifieerde sessie opnieuw gebruiken om Connect-PowerBIServiceAccount 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 vanuit de cmdlets, gebruikt u:

Resolve-PowerBIError -Last

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

Problemen en feedback

Als u fouten vindt of bepaalde functionaliteit wilt zien die is geïmplementeerd voor de PowerShell-cmdlets voor Power BI, dient u een probleem in.

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