Rutiny Microsoft Power BI pro Windows PowerShell a PowerShell Core

Článek
05/12/2023

Vítá vás referenční informace k PowerShellu pro Microsoft Power BI. Tady najdete prostředky pro moduly PowerShellu, které cílí na Power BI.

Moduly PowerShellu

Níže je tabulka modulů PowerShellu Power BI, které jsou popsané v tomto odkazu.

Description	Název modulu	odkaz na Galerie prostředí PowerShell
Souhrnný modul pro rutiny Power BI	MicrosoftPowerBIMgmt
modul Správa pro rutiny Power BI	MicrosoftPowerBIMgmt.Admin
Modul Kapacity pro rutiny Power BI	MicrosoftPowerBIMgmt.Capacities
Datový modul pro rutiny Power BI	MicrosoftPowerBIMgmt.Data
Modul profilu pro rutiny Power BI	MicrosoftPowerBIMgmt.Profile
Modul Sestavy pro Power BI	MicrosoftPowerBIMgmt.Reports
Modul Pracovní prostory pro Power BI	MicrosoftPowerBIMgmt.Workspaces

Podporovaná prostředí a verze PowerShellu

Windows PowerShell verze 3.0 a vyšší s .NET 4.7.1 nebo novějším.
PowerShell Core (v6) a novější na libovolné platformě operačního systému, kterou podporuje PowerShell Core.

Instalace

Rutiny jsou k dispozici na Galerie prostředí PowerShell a dají se nainstalovat v relaci PowerShellu se zvýšenými oprávněními:

Install-Module -Name MicrosoftPowerBIMgmt

Volitelně můžete místo souhrnného modulu nainstalovat jednotlivé moduly (na základě vašich potřeb), například pokud jste chtěli jenom modul Pracovní prostory:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Pokud máte starší verzi, můžete aktualizovat na nejnovější verzi spuštěním příkazu:

Update-Module -Name MicrosoftPowerBIMgmt

Odinstalace

Pokud chcete odinstalovat všechny rutiny PowerShellu Power BI, spusťte v relaci PowerShellu se zvýšenými oprávněními následující:

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

Využití

Rutiny, které pracují s entitami Power BI, podporují dva obory:

Jednotlivec se používá pro přístup k entitě, které patří aktuálnímu uživateli.
Organizace se používá k přístupu k entitě v celé společnosti. Používat můžou jenom správci tenantů Power BI.

Pokud parametr -Scope v rutině neexistuje, entita nepodporuje rozhraní API pro správu.

Přihlášení k Power BI

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

Získání pracovních prostorů

Získejte pracovní prostory pro uživatele. Ve výchozím nastavení (tj. bez -First parametru) zobrazuje prvních 100 pracovních prostorů přiřazených uživateli:

Get-PowerBIWorkspace

Pomocí parametru -All zobrazte všechny pracovní prostory přiřazené uživateli:

Get-PowerBIWorkspace -All

Pokud jste správce tenanta, můžete zobrazit všechny pracovní prostory ve vašem tenantovi přidáním -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Aktualizace pracovního prostoru

Aktualizujte název nebo popis pracovního prostoru uživatele:

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

Přidání nového uživatele do pracovního prostoru

Přidejte uživatele do daného pracovního prostoru:

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

Odebrání uživatele z daného pracovního prostoru

Odeberte oprávnění uživatele z daného pracovního prostoru:

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

Získání stavu migrace pracovního prostoru

Získání stavu migrace pracovního prostoru Power BI:

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

Obnovení pracovního prostoru

Zobrazení odstraněných pracovních prostorů jako správce tenanta:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Obnovení odstraněného pracovního prostoru:

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

Obnovení osamoceného pracovního prostoru

Pracovní prostor se stane osamoceným, pokud nemá přiřazené správce. Pokud jste správce tenanta, spuštěním následujícího příkazu zobrazte všechny osamocené pracovní prostory:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Pokud chcete tento problém opravit, použijte:

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

Získání sestav

Získejte všechny sestavy pro uživatele:

Get-PowerBIReport

Pokud jste správce tenanta, můžete zobrazit všechny sestavy ve vašem tenantovi pomocí přiřazení -Scope Organization:

Get-PowerBIReport -Scope Organization

Získání řídicích panelů

Získání řídicích panelů pro uživatele:

Get-PowerBIDashboard

Pokud jste správce tenanta, můžete zobrazit všechny řídicí panely ve vašem tenantovi přidáním -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Získání dlaždic

Získání dlaždic na řídicím panelu:

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

Získání importů

Získání importů Power BI:

Get-PowerBIImport

Vytvoření sestavy

Vytvořte sestavu v Power BI nahráním souboru *.pbix:

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

Ve výchozím nastavení se sestava umístí do pracovního prostoru uživatele. Pokud chcete umístit jiný pracovní prostor, použijte tyto -WorkspaceId parametry -Workspace :

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

Export sestavy

Export sestavy Power BI do souboru *.pbix:

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

Pokud pracovní prostor existuje mimo pracovní prostor, exportujte pomocí parametru nebo -Workspace parametruWorkspaceId:

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

Získání datových sad

Získání datových sad Power BI:

Get-PowerBIDataset

Aktualizace režimu úložiště datové sady

Nastavte datovou sadu Power BI tak, aby používala Premium Files pro režim úložiště:

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

Získání zdrojů dat

Získejte zdroje dat Power BI pro datovou sadu:

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

Získání tabulek

Získejte tabulky Power BI obsažené v datové sadě:

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

Volání rozhraní Power BI REST API

Pro API Power BI, které nemají odpovídající rutiny, můžete znovu použít ověřenou relaci, Connect-PowerBIServiceAccount abyste mohli vytvářet vlastní požadavky REST:

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)

Pokud chcete použít ověřenou relaci mimo PowerShell, získejte přístupový token pomocí:

Get-PowerBIAccessToken -AsString

Řešení chyb

Pokud chcete získat další informace o chybě vrácené zpět z rutin, použijte:

Resolve-PowerBIError -Last

Tyto informace můžou být užitečné pro otevírání lístků podpory pro Power BI.

Problémy a zpětná vazba

Pokud zjistíte nějaké chyby nebo chcete zobrazit určité funkce implementované pro rutiny PowerShellu pro Power BI, založte problém.

Pokud je váš problém širší než jenom rutiny PowerShellu, pošlete nám svůj názor na Komunita Power BI nebo oficiální web podpory Power BI.

Sdílet prostřednictvím