Windows PowerShell ve PowerShell Core için Microsoft Power BI Cmdlet'leri

Microsoft Power BI için PowerShell başvurusuna hoş geldiniz. Burada Power BI'ı hedefleyen PowerShell modülleri için kaynaklar bulacaksınız.

PowerShell modülleri

Aşağıda, bu başvuruda ele alınan Power BI PowerShell modüllerinin bir tablosu yer almaktadır.

Açıklama	Modül Adı	PowerShell Galerisi bağlantısı
Power BI Cmdlet'leri için toplama modülü	NA
Power BI Cmdlet'leri için yönetici modülü	MicrosoftPowerBIMgmt.Admin Module
Power BI Cmdlet'leri için kapasiteler modülü	MicrosoftPowerBIMgmt.Capacities Module
Power BI Cmdlet'leri için veri modülü	MicrosoftPowerBIMgmt.Data Module
Power BI Cmdlet'leri için profil modülü	MicrosoftPowerBIMgmt.Profile Module
Power BI için raporlar modülü	MicrosoftPowerBIMgmt.Reports Module
Power BI için çalışma alanları modülü	MicrosoftPowerBIMgmt.Workspaces Module

Desteklenen ortamlar ve PowerShell sürümleri

• Windows PowerShell v3.0 ve üzeri .NET 4.7.1 veya üzeri.
• PowerShell Core (v6) ve üstü, PowerShell Core tarafından desteklenen herhangi bir işletim sistemi platformunda.

Kurulum

Cmdlet'ler PowerShell Galerisi'nde kullanılabilir ve yükseltilmiş bir PowerShell oturumuna yüklenebilir:

Install-Module -Name MicrosoftPowerBIMgmt

İsteğe bağlı olarak, örneğin yalnızca Çalışma Alanları modülünü istiyorsanız, toplama modülü yerine tek tek modülleri (ihtiyaçlarınıza göre) yükleyebilirsiniz:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Daha eski bir sürüme sahipseniz, aşağıdakileri çalıştırarak en son sürüme güncelleyebilirsiniz:

Update-Module -Name MicrosoftPowerBIMgmt

Kaldır

Tüm Power BI PowerShell cmdlet'lerini kaldırmak istiyorsanız, yükseltilmiş bir PowerShell oturumunda aşağıdakileri çalıştırın:

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

Kullanım

Power BI varlıklarıyla etkileşim kuran cmdlet'ler tarafından iki kapsam desteklenir:

• Bireysel, geçerli kullanıcıya ait varlıklara erişmek için kullanılır.
• Organizasyon, tüm şirketteki varlıklara erişmek için kullanılır. Yalnızca Power BI kiracı yöneticilerinin kullanmasına izin verilir.

-Scope parametresi cmdlet'te yoksa, varlık bir Yönetim API'sini desteklemiyor demektir.

Power BI'da oturum açma

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

Çalışma alanlarını edinin

Kullanıcı için çalışma alanları edinin. Varsayılan olarak (yani parametre olmadan -First ) kullanıcıya atanan ilk 100 çalışma alanını gösterir:

Get-PowerBIWorkspace

-All Kullanıcıya atanan tüm çalışma alanlarını göstermek için parametresini kullanın:

Get-PowerBIWorkspace -All

Kiracı yöneticisiyseniz, aşağıdakileri ekleyerek -Scope Organizationkiracınızdaki tüm çalışma alanlarını görüntüleyebilirsiniz:

Get-PowerBIWorkspace -Scope Organization -All

Çalışma alanını güncelleştirme

Kullanıcının çalışma alanının adını veya açıklamasını güncelleştirin:

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

Çalışma alanına yeni kullanıcı ekleme

Belirli bir çalışma alanına kullanıcı ekleme:

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

Belirli bir çalışma alanından kullanıcı kaldırma

Belirli bir çalışma alanından kullanıcının izinlerini kaldırın:

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

Çalışma alanı geçiş durumunu alma

Power BI çalışma alanı geçiş durumunu alın:

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

Çalışma alanını geri yükleme

Silinen çalışma alanlarını kiracı yöneticisi olarak görüntülemek için:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Silinen bir çalışma alanını geri yükleme:

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

Yalnız bırakılmış bir çalışma alanını kurtarma

Bir çalışma alanı, atanmış yöneticisi olmadığında yalnız bırakılır. Kiracı yöneticisiyseniz, tüm yalnız bırakılmış çalışma alanlarını görüntülemek için aşağıdakileri çalıştırın:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Bu sorunu düzeltmek için şunu kullanın:

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

Rapor alın

Kullanıcı için tüm raporları alın:

Get-PowerBIReport

Kiracı yöneticisiyseniz, atamayı -Scope Organizationkullanarak kiracınızdaki tüm raporları görüntüleyebilirsiniz:

Get-PowerBIReport -Scope Organization

Panoları edinme

Kullanıcı için panoları alın:

Get-PowerBIDashboard

Kiracı yöneticisiyseniz, aşağıdakileri ekleyerek -Scope Organizationkiracınızdaki tüm panoları görüntüleyebilirsiniz:

Get-PowerBIDashboard -Scope Organization

Fayans alma

Panodaki kutucukları alın:

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

İçe aktarmaları alın

Power BI içeri aktarmalarını alın:

Get-PowerBIImport

Rapor oluşturma

Bir *.pbix dosyası yükleyerek Power BI'da bir rapor oluşturun:

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

Varsayılan olarak, rapor kullanıcının Çalışma Alanım'a yerleştirilir. Farklı bir çalışma alanına yerleştirmek için veya -Workspace parametrelerini kullanın-WorkspaceId:

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

Raporu dışarı aktarma

Power BI raporunu *.pbix dosyasına aktarın:

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

Çalışma alanı Çalışma Alanım'ın dışında bulunuyorsa, veya -Workspace parametresiyle WorkspaceId dışarı aktarın:

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

Veri kümelerini alma

Power BI veri kümelerini alın:

Get-PowerBIDataset

Veri kümesi depolama modunu güncelleştirme

Power BI veri kümesini depolama modu için Premium Dosyalar kullanacak şekilde ayarlayın:

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

Veri kaynaklarını alma

Bir veri kümesi için Power BI veri kaynaklarını alma:

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

Tabloları al

Bir veri kümesinde yer alan Power BI tablolarını alın:

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

Power BI Rest API'sini çağırma

Karşılık gelen cmdlet'lere sahip olmayan Power BI API'si için, özel REST istekleri yapmak üzere kimliği doğrulanmış oturumu Connect-PowerBIServiceAccount yeniden kullanabilirsiniz:

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)

Kimliği doğrulanmış oturumu PowerShell dışında kullanmak istiyorsanız, aşağıdakileri kullanarak erişim belirtecini alın:

Get-PowerBIAccessToken -AsString

Hataları giderme

Cmdlet'lerden geri döndürülen bir hata hakkında daha fazla bilgi almak için şunu kullanın:

Resolve-PowerBIError -Last

Bu bilgiler, Power BI için destek biletleri açmak için yararlı olabilir.

Sorunlar ve geri bildirim

Herhangi bir hata bulursanız veya Power BI için PowerShell Cmdlet'leri için belirli işlevlerin uygulandığını görmek isterseniz lütfen bir sorun bildirin.

Sorununuz PowerShell cmdlet'lerinden daha genişse, lütfen geri bildiriminizi Power BI Topluluğu'na veya resmi Power BI Destek sitesine gönderin.