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üllerinin kaynaklarını bulabilirsiniz.

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ü	MicrosoftPowerBIMgmt
Power BI Cmdlet'leri için Yönetici modülü	MicrosoftPowerBIMgmt.Admin
Power BI Cmdlet'leri için kapasiteler modülü	MicrosoftPowerBIMgmt.Capacities
Power BI Cmdlet'leri için veri modülü	MicrosoftPowerBIMgmt.Data
Power BI Cmdlet'leri için profil modülü	MicrosoftPowerBIMgmt.Profile
Power BI için Raporlar modülü	MicrosoftPowerBIMgmt.Reports
Power BI için çalışma alanları modülü	MicrosoftPowerBIMgmt.Workspaces

Desteklenen ortamlar ve PowerShell sürümleri

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

Yükleme

Cmdlet'ler PowerShell Galerisi 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 (gereksinimlerinize göre) yükleyebilirsiniz:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Daha önceki bir sürümünüz varsa, şunu çalıştırarak en son sürüme güncelleştirebilirsiniz:

Update-Module -Name MicrosoftPowerBIMgmt

Kaldırma

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.
• Kuruluş, tüm şirket genelinde varlıklara erişmek için kullanılır. Yalnızca Power BI kiracı yöneticilerinin kullanmasına izin verilir.

cmdlet'inde -Scope parametresi yoksa varlık Yönetim API'sini desteklemez.

Power BI'da oturum açma

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

Çalışma alanlarını alma

Kullanıcı için çalışma alanları alın. Varsayılan olarak (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, 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 ç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ış çalışma alanını kurtarma

Atanmış yönetici olmadığında çalışma alanı yalnız kalır. Kiracı yöneticisiyseniz, yalnız bırakılmış tüm ç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 alma

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

Get-PowerBIReport

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

Get-PowerBIReport -Scope Organization

Panoları alma

Kullanıcı için panoları alma:

Get-PowerBIDashboard

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

Get-PowerBIDashboard -Scope Organization

Kutucukları alma

Pano içindeki kutucukları alma:

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

İçeri aktarmaları alma

Power BI içeri aktarmalarını alma:

Get-PowerBIImport

Rapor oluşturma

*.pbix dosyasını karşıya yükleyerek Power BI'da rapor oluşturun:

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

Varsayılan olarak, rapor kullanıcının Çalışma Alanım bölümüne 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 dışındaysa veya -Workspace parametresiyle dışarı aktarınWorkspaceId:

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 alma:

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ı alma

Bir veri kümesinin içinde yer alan Power BI tablolarını alma:

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

Power BI Rest API'sini çağırma

karşılık gelen cmdlet'leri olmayan Power BI API için, özel REST istekleri yapmak için kimliği doğrulanmış oturumunu 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

Hatalarda sorun giderme

Cmdlet'lerden döndürülen bir hata hakkında daha fazla bilgi edinmek 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 istiyorsanız lütfen bir sorun oluşturun.

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