Rutiny Microsoft Power BI pro Windows PowerShell a PowerShell Core

Vítá vás referenční příručka k prostředí PowerShell pro Microsoft Power BI. Zde najdete zdroje informací pro moduly PowerShell cílené na Power BI.

PowerShell moduly

Níže je uvedena tabulka modulů Power BI PowerShell popsaných v tomto odkazu.

Popis	Název modulu	Odkaz na Galerie prostředí PowerShell
Souhrnný modul pro rutiny Power BI	Na
Modul pro správu rutin Power BI	MicrosoftPowerBIMgmt.Admin Module
Modul kapacit pro rutiny Power BI	MicrosoftPowerBIMgmt.Capacities Module
Datový modul pro rutiny Power BI	MicrosoftPowerBIMgmt.Data Module
Modul profilu pro rutiny Power BI	MicrosoftPowerBIMgmt.Profile Module
Modul reportů pro Power BI	MicrosoftPowerBIMgmt.Reports Module
Modul pracovních prostorů pro Power BI	MicrosoftPowerBIMgmt.Workspaces Module

Podporovaná prostředí a verze PowerShellu

• Windows PowerShell verze 3.0 a vyšší s rozhraním .NET 4.7.1 nebo novějším.
• PowerShell Core (v6) a novější na jakékoli platformě operačního systému podporované PowerShellem Core.

Instalace

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

Install-Module -Name MicrosoftPowerBIMgmt

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

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Pokud máte starší verzi, můžete aktualizaci na nejnovější verzi spustit příkazem:

Update-Module -Name MicrosoftPowerBIMgmt

Odinstalace produktu

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

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

Použití

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

• Individuální se používá pro přístup k entitám, které patří aktuálnímu uživateli.
• Organizace se používá pro přístup k entitám napříč celou společností. Používat mohou pouze správci tenanta Power BI.

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

Přihlaste se do 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 zobrazíte všechny pracovní prostory přiřazené uživateli:

Get-PowerBIWorkspace -All

Pokud jste správcem klienta, můžete zobrazit všechny pracovní prostory ve svém klientovi přidáním -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Aktualizace pracovního prostoru

Aktualizujte název nebo popis pracovní plochy 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í plochy

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

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

Odebrání 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

Zjiště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 klienta:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Obnovení odstraněné pracovní plochy:

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

Obnovení osiřelé pracovní plochy

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

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Chcete-li tento problém vyřešit, použijte následující příkaz:

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

Získání reportů

Získat všechny zprávy pro uživatele:

Get-PowerBIReport

Pokud jste správcem klienta, můžete zobrazit všechny sestavy ve svém klientovi 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ávcem klienta, můžete zobrazit všechny řídicí panely ve svém klientovi přidáním -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Získat dlaždice

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

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

Získání importů

Získání importů z Power BI:

Get-PowerBIImport

Vytvořte sestavu

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

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

Ve výchozím nastavení je sestava umístěna do složky Můj pracovní prostor uživatele. Chcete-li umístit do jiné pracovní plochy, použijte parametry -WorkspaceId nebo -Workspace :

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

Exportovat sestavu

Export sestavy Power BI do souboru *.pbix:

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

Pokud pracovní plocha existuje mimo složku Můj pracovní prostor, exportujte s parametrem WorkspaceId or -Workspace :

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 ukládání:

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

Získání zdrojů dat

Získání zdrojů dat Power BI pro datovou sadu:

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

Získání tabulek

Získání tabulek Power BI obsažených v datové sadě:

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

Volání rozhraní REST API Power BI

V případě rozhraní API Power BI , které postrádá odpovídající rutiny, můžete ověřenou relaci z Connect-PowerBIServiceAccount znovu použít k vytvoření vlastních požadavků 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 mohou být užitečné při otevírání lístků podpory pro Power BI.

Problémy a názory

Pokud najdete nějaké chyby nebo chcete vidět určité funkce implementované pro rutiny PowerShell pro Power BI, nahlaste problém.

Pokud je váš problém širší než jen rutiny PowerShellu, odešlete svůj názor komunitě Power BI nebo oficiálnímu webu podpory Power BI .