Microsoft Power BI-cmdlets voor Windows PowerShell en PowerShell Core

Artikel
05/12/2023

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
Beheer module voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Admin
Capaciteitsmodule voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Capacities
Gegevensmodule voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Data
Profielmodule voor Power BI-cmdlets	MicrosoftPowerBIMgmt.Profile
Rapportmodule voor Power BI	MicrosoftPowerBIMgmt.Reports
Werkruimtemodule voor Power BI	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.

Delen via