Cmdlet Microsoft Power BI untuk Windows PowerShell dan PowerShell Core

Selamat datang di referensi PowerShell untuk Microsoft Power BI. Di sini Anda akan menemukan sumber daya untuk modul PowerShell yang menargetkan Power BI.

Modul PowerShell

Di bawah ini adalah tabel modul Power BI PowerShell yang tercakup dalam referensi ini.

Deskripsi	Nama Modul	Tautan Galeri PowerShell
Modul rollup untuk Cmdlet Power BI	NA
Modul admin untuk Power BI Cmdlets	MicrosoftPowerBIMgmt.Admin Module
Modul kapasitas untuk Cmdlet Power BI	MicrosoftPowerBIMgmt.Capacities Module
Modul data untuk Cmdlet Power BI	MicrosoftPowerBIMgmt.Data Module
Modul profil untuk Power BI Cmdlets	MicrosoftPowerBIMgmt.Profile Module
Modul laporan untuk Power BI	MicrosoftPowerBIMgmt.Reports Module
Modul ruang kerja untuk Power BI	MicrosoftPowerBIMgmt.Workspaces Module

Lingkungan yang didukung dan versi PowerShell

• Windows PowerShell v3.0 dan yang lebih baru dengan .NET 4.7.1 atau yang lebih tinggi.
• PowerShell Core (v6) dan yang lebih tinggi pada platform OS apa pun yang didukung oleh PowerShell Core.

Instalasi

Cmdlet tersedia di Galeri PowerShell dan dapat diinstal dalam sesi PowerShell yang ditingkatkan:

Install-Module -Name MicrosoftPowerBIMgmt

Secara opsional, Anda dapat menginstal modul individual (berdasarkan kebutuhan Anda) alih-alih modul rollup, misalnya jika Anda hanya menginginkan modul Ruang Kerja:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Jika Anda memiliki versi yang lebih lama, Anda dapat memperbarui ke versi terbaru dengan menjalankan:

Update-Module -Name MicrosoftPowerBIMgmt

Uninstal

Jika Anda ingin menghapus semua cmdlet Power BI PowerShell, jalankan hal berikut ini dalam sesi PowerShell yang ditingkatkan:

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

Penggunaan

Dua cakupan didukung oleh cmdlet yang berinteraksi dengan entitas Power BI:

• Individu digunakan untuk mengakses entitas milik pengguna saat ini.
• Organisasi digunakan untuk mengakses entitas di seluruh perusahaan. Hanya admin penyewa Power BI yang diizinkan untuk menggunakan.

Jika parameter -Scope tidak ada pada cmdlet, entitas tidak mendukung API Administratif.

Masuk ke Power BI

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

Mendapatkan ruang kerja

Dapatkan ruang kerja untuk pengguna. Secara default (yaitu tanpa -First parameter) ini menunjukkan 100 ruang kerja pertama yang ditetapkan kepada pengguna:

Get-PowerBIWorkspace

Gunakan parameter untuk -All menampilkan semua ruang kerja yang ditetapkan kepada pengguna:

Get-PowerBIWorkspace -All

Jika Anda adalah administrator penyewa, Anda dapat melihat semua ruang kerja di penyewa Anda dengan menambahkan -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Memperbarui ruang kerja

Perbarui nama atau deskripsi ruang kerja pengguna:

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

Menambahkan pengguna baru ke ruang kerja

Tambahkan pengguna ke ruang kerja tertentu:

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

Menghapus pengguna dari ruang kerja tertentu

Menghapus izin pengguna dari ruang kerja tertentu:

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

Mendapatkan status migrasi ruang kerja

Dapatkan status migrasi ruang kerja Power BI:

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

Memulihkan ruang kerja

Untuk melihat ruang kerja yang dihapus sebagai administrator penyewa:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Memulihkan ruang kerja yang dihapus:

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

Memulihkan ruang kerja yatim piatu

Ruang kerja menjadi yatim piatu ketika tidak memiliki administrator yang ditetapkan. Jika Anda adalah administrator penyewa, jalankan hal berikut untuk melihat semua ruang kerja yatim piatu:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Untuk memperbaiki masalah ini, gunakan:

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

Mendapatkan laporan

Dapatkan semua laporan untuk pengguna:

Get-PowerBIReport

Jika Anda adalah administrator penyewa, Anda dapat melihat semua laporan di penyewa Anda dengan menggunakan penetapan -Scope Organization:

Get-PowerBIReport -Scope Organization

Dapatkan dasbor

Dapatkan dasbor untuk pengguna:

Get-PowerBIDashboard

Jika Anda adalah administrator penyewa, Anda dapat melihat semua dasbor di penyewa Anda dengan menambahkan -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Mendapatkan ubin

Mendapatkan ubin dalam dasbor:

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

Dapatkan impor

Mendapatkan impor Power BI:

Get-PowerBIImport

Membuat laporan

Buat laporan di Power BI dengan mengunggah file *.pbix:

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

Secara default, laporan ditempatkan di Ruang Kerja Saya pengguna. Untuk menempatkan di ruang kerja yang berbeda, gunakan -WorkspaceId parameter atau -Workspace :

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

Mengekspor laporan

Mengekspor laporan Power BI ke file *.pbix:

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

Jika ruang kerja ada di luar Ruang Kerja Saya, ekspor dengan WorkspaceId parameter atau -Workspace :

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

Mendapatkan himpunan data

Dapatkan himpunan data Power BI:

Get-PowerBIDataset

Perbarui mode penyimpanan himpunan data

Atur himpunan data Power BI untuk menggunakan File Premium untuk mode penyimpanan:

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

Mendapatkan sumber data

Dapatkan sumber data Power BI untuk himpunan data:

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

Mendapatkan tabel

Dapatkan tabel Power BI yang terkandung dalam himpunan data:

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

Panggil Power BI Rest API

Untuk Power BI API yang tidak memiliki cmdlet yang sesuai, Anda dapat menggunakan kembali sesi yang diautentikasi untuk Connect-PowerBIServiceAccount membuat permintaan REST kustom:

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)

Jika Anda ingin menggunakan sesi yang diautentikasi di luar PowerShell, dapatkan token akses dengan menggunakan:

Get-PowerBIAccessToken -AsString

Pemecahan Masalah Kesalahan

Untuk mendapatkan informasi selengkapnya tentang kesalahan yang dikembalikan dari cmdlet, gunakan:

Resolve-PowerBIError -Last

Informasi ini dapat berguna untuk membuka tiket dukungan untuk Power BI.

Isu-isu dan umpan balik

Jika Anda menemukan bug atau ingin melihat fungsionalitas tertentu diterapkan untuk PowerShell Cmdlet untuk Power BI, silakan ajukan masalah.

Jika masalah Anda lebih luas dari sekadar cmdlet PowerShell, kirimkan umpan balik Anda ke Komunitas Power BI atau situs resmi Dukungan Power BI .