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 PowerShell Power BI yang tercakup dalam referensi ini.

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

Lingkungan yang didukung dan versi PowerShell

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

Penginstalan

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

Hapus instalasi

Jika Anda ingin menghapus instalan semua cmdlet PowerShell Power BI, 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 digunakan.

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

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

Get-PowerBIWorkspace

-All Gunakan parameter untuk menampilkan semua ruang kerja yang ditetapkan untuk 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

Hapus 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

Mendapatkan 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 tanpa sumber

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

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

Mendapatkan 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

Dapatkan petak peta

Dapatkan petak peta dalam dasbor:

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

Mendapatkan 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

Ekspor 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

Mendapatkan himpunan data Power BI:

Get-PowerBIDataset

Memperbarui 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

Memanggil Rest API Power BI

Untuk API Power BI yang tidak memiliki cmdlet yang sesuai, Anda dapat menggunakan kembali sesi yang diautentikasi dari Connect-PowerBIServiceAccount untuk 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 terautentikasi 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.

Masalah dan umpan balik

Jika Anda menemukan bug atau ingin melihat fungsionalitas tertentu yang diterapkan untuk Cmdlet PowerShell 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 Dukungan Power BI resmi.