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.