Microsoft Power BI-parancsmagok a Windows PowerShell-hez és a PowerShell Core-hoz

Cikk
05/12/2023

Üdvözli a Microsoft Power BI PowerShell-referenciája. Itt a Power BI-t célzó PowerShell-modulok erőforrásait találja.

PowerShell-modulok

Az alábbi táblázat a power BI PowerShell-modulokat ismerteti ebben a referenciaanyagban.

Description	Modulnév	PowerShell-galéria hivatkozás
Összesítő modul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt
Rendszergazda Modul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Admin
Kapacitásmodul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Capacities
Adatmodul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Data
Profilmodul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Profile
Jelentések modul a Power BI-hoz	MicrosoftPowerBIMgmt.Reports
Munkaterületek modul a Power BI-hoz	MicrosoftPowerBIMgmt.Workspaces

Támogatott környezetek és PowerShell-verziók

Windows PowerShell 3.0-s vagy újabb verziót a .NET 4.7.1 vagy újabb verziójával.
A PowerShell Core (v6) és a PowerShell Core által támogatott bármely operációsrendszer-platformon felfelé.

Telepítés

A parancsmagok PowerShell-galéria érhetők el, és emelt szintű PowerShell-munkamenetben telepíthetők:

Install-Module -Name MicrosoftPowerBIMgmt

Igény szerint egyes modulokat is telepíthet (az igényeinek megfelelően) az összesítő modul helyett, például ha csak a Workspaces modult szeretné:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Ha rendelkezik korábbi verzióval, a következő parancs futtatásával frissíthet a legújabb verzióra:

Update-Module -Name MicrosoftPowerBIMgmt

Eltávolítás

Ha el szeretné távolítani az összes Power BI PowerShell-parancsmagot, futtassa a következőt egy emelt szintű PowerShell-munkamenetben:

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

Használat

A Power BI-entitásokkal kommunikáló parancsmagok két hatókört támogatnak:

Az egyén az aktuális felhasználóhoz tartozó entitásokhoz való hozzáférésre szolgál.
A szervezet az egész vállalat entitásaihoz való hozzáférésre szolgál. Csak a Power BI-bérlő rendszergazdái használhatják.

Ha a -Scope paraméter nem létezik a parancsmagon, az entitás nem támogatja a felügyeleti API-t.

Bejelentkezés a Power BI-ba

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

Munkaterületek lekérése

Munkaterületek lekérése a felhasználó számára. Alapértelmezés szerint (azaz paraméter nélkül -First ) a felhasználóhoz rendelt első 100 munkaterületet jeleníti meg:

Get-PowerBIWorkspace

A paraméter használatával -All megjelenítheti a felhasználóhoz rendelt összes munkaterületet:

Get-PowerBIWorkspace -All

Ha Ön bérlői rendszergazda, a következő hozzáadásával tekintheti meg a bérlő összes munkaterületét -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Munkaterület frissítése

Frissítse a felhasználó munkaterületének nevét vagy leírását:

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

Új felhasználó hozzáadása munkaterülethez

Felhasználó hozzáadása egy adott munkaterülethez:

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

Felhasználó eltávolítása egy adott munkaterületről

Felhasználó engedélyeinek eltávolítása egy adott munkaterületről:

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

Munkaterület migrálási állapotának lekérése

A Power BI-munkaterület migrálási állapotának lekérése:

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

Munkaterület visszaállítása

Törölt munkaterületek megtekintése bérlői rendszergazdaként:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Törölt munkaterület visszaállítása:

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

Árva munkaterület helyreállítása

Egy munkaterület árva lesz, ha nincs hozzárendelt rendszergazdája. Ha Ön bérlői rendszergazda, futtassa az alábbi parancsot az összes árva munkaterület megtekintéséhez:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

A probléma megoldásához használja a következőt:

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

Jelentések lekérése

A felhasználó összes jelentésének lekérése:

Get-PowerBIReport

Ha Ön bérlői rendszergazda, a bérlőben lévő összes jelentést megtekintheti a következő hozzárendeléssel -Scope Organization:

Get-PowerBIReport -Scope Organization

Irányítópultok lekérése

Irányítópultok lekérése a felhasználó számára:

Get-PowerBIDashboard

Ha Ön bérlői rendszergazda, a következő hozzáadásával tekintheti meg a bérlő -Scope Organizationösszes irányítópultját:

Get-PowerBIDashboard -Scope Organization

Csempék lekérése

Csempék lekérése egy irányítópulton belül:

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

Importálások lekérése

Power BI-importálások lekérése:

Get-PowerBIImport

Jelentés létrehozása

Hozzon létre egy jelentést a Power BI-ban egy *.pbix-fájl feltöltésével:

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

Alapértelmezés szerint a jelentés a felhasználó Saját munkaterületére kerül. Ha másik munkaterületre szeretne helyezni, használja a -WorkspaceId következő -Workspace paramétereket:

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

Jelentés exportálása

Power BI-jelentés exportálása *.pbix-fájlba:

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

Ha a munkaterület a Saját munkaterületen kívül található, exportálja a WorkspaceId következő paraméterrel -Workspace :

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

Adathalmazok lekérése

Power BI-adathalmazok lekérése:

Get-PowerBIDataset

Adathalmaz tárolási módjának frissítése

Állítsa be a Power BI-adatkészletet a Premium Files tárolási módra való használatára:

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

Adatforrások lekérése

Power BI-adatforrások lekérése adathalmazhoz:

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

Táblák lekérése

Adathalmazban található Power BI-táblák lekérése:

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

Power BI REST API hívása

A megfelelő parancsmagokat nem tartalmazó Power BI API esetében újra felhasználhatja a hitelesített munkamenetet Connect-PowerBIServiceAccount egyéni REST-kérések létrehozásához:

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)

Ha a hitelesített munkamenetet a PowerShellen kívül szeretné használni, kérje le a hozzáférési jogkivonatot a következő használatával:

Get-PowerBIAccessToken -AsString

Hibaelhárítás

A parancsmagok által visszaadott hibával kapcsolatos további információkért használja a következőt:

Resolve-PowerBIError -Last

Ez az információ hasznos lehet a Power BI támogatási jegyeinek megnyitásához.

Problémák és visszajelzés

Ha hibát talál, vagy látni szeretné a Power BI-hoz készült PowerShell-parancsmagokhoz implementált bizonyos funkciókat, jelentsen be egy problémát.

Ha a probléma szélesebb körű, mint a PowerShell-parancsmagok, küldje el visszajelzését a Power BI-közösség vagy a Power BI hivatalos támogatási webhelyén.

Megosztás a következőn keresztül: