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

Üdvözöljük a Microsoft Power BI PowerShell-referenciájában. Itt talál erőforrásokat a Power BI-t célzó PowerShell-modulokhoz.

PowerShell-modulok

Az alábbiakban a referencia által ismertetett Power BI PowerShell-modulok táblázata látható.

Leírás	Modul neve	PowerShell-galéria hivatkozása
Összesítő modul Power BI-parancsmagokhoz	N/A
Felügyeleti modul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Admin Module
Kapacitások modul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Capacities Module
Adatmodul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Data Module
Profilmodul Power BI-parancsmagokhoz	MicrosoftPowerBIMgmt.Profile Module
Jelentések modul a Power BI-hoz	MicrosoftPowerBIMgmt.Reports Module
Munkaterületek modul a Power BI-hoz	MicrosoftPowerBIMgmt.Workspaces Module

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

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

Telepítés

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

Install-Module -Name MicrosoftPowerBIMgmt

Igény szerint az összesítő modul helyett külön modulokat is telepíthet (az igényei szerint), például ha csak a Munkaterületek modult szeretne:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

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

Update-Module -Name MicrosoftPowerBIMgmt

Program eltávolítása

Ha el szeretné távolítani az összes Power BI PowerShell-parancsmagot, futtassa a következőket 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éni az aktuális felhasználóhoz tartozó entitások elérésére szolgál.
• A szervezet a teljes vállalat entitásainak elérésére szolgál. Csak a Power BI-bérlői rendszergazdák használhatják.

Ha a -Scope paraméter nem létezik a parancsmagban, 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 beszerzé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 -All paraméterrel megjelenítheti a felhasználóhoz rendelt összes munkaterületet:

Get-PowerBIWorkspace -All

Ha Ön bérlői rendszergazda, a bérlő összes munkaterületét megtekintheti a következő hozzáadásával -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ói engedélyek 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 áttelepítési állapotának lekérése

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

A munkaterület árván válik, ha nincs hozzárendelt rendszergazdája. Ha Ön bérlői rendszergazda, futtassa a következőket 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

Az összes jelentés lekérése a felhasználó számára:

Get-PowerBIReport

Ha Ön bérlői rendszergazda, a bérlő összes jelentését megtekintheti a következő -Scope Organizationhasználatával:

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 bérlő összes irányítópultját megtekintheti a következő hozzáadásával -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Csempék beszerzése

Csempék lekérése az irányítópulton:

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

Importálások lekérése

Power BI-importálások beszerzé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 vagy -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 vagy -Workspace paraméterrel:

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

Adatkészletek lekérése

Power BI-adatkészletek lekérése:

Get-PowerBIDataset

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

Állítsa be a Power BI-adatkészletet a Prémium fájlok tárolási módhoz:

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

A Power BI Rest API hívása

A megfelelő parancsmagokkal nem rendelkező Power BI API esetében a hitelesített munkamenetet Connect-PowerBIServiceAccount újra felhasználhatja egyéni REST-kérések készítéséhez:

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, szerezze be a hozzáférési jogkivonatot a következővel:

Get-PowerBIAccessToken -AsString

Hibaelhárítás

Ha további információt szeretne kapni a parancsmagok által visszaadott hibáról, használja a következőt:

Resolve-PowerBIError -Last

Ezek az információk hasznosak lehetnek a Power BI támogatási jegyeinek megnyitásához.

Problémák és visszajelzés

Ha hibákat talál, vagy szeretne bizonyos funkciókat megvalósítani a Power BI-hoz készült PowerShell-parancsmagokhoz, jelentsen be egy problémát.

Ha a probléma a PowerShell-parancsmagoknál szélesebb körű, küldje el visszajelzését a Power BI-közösségnek vagy a hivatalos Power BI-támogatási webhelynek.