Polecenia cmdlet usługi Microsoft Power BI dla Windows PowerShell i programu PowerShell Core

Dokumentacja programu PowerShell dla usługi Microsoft Power BI — Zapraszamy! W tym miejscu znajdziesz zasoby dla modułów programu PowerShell przeznaczonych dla usługi Power BI.

Moduły programu PowerShell

Poniżej znajduje się tabela modułów programu PowerShell usługi Power BI omówionych w tej dokumentacji.

Opis	Nazwa modułu	link Galeria programu PowerShell
Moduł zestawienia poleceń cmdlet usługi Power BI	MicrosoftPowerBIMgmt
moduł Administracja dla poleceń cmdlet usługi Power BI	MicrosoftPowerBIMgmt.Admin
Moduł pojemności dla poleceń cmdlet usługi Power BI	MicrosoftPowerBIMgmt.Capacities
Moduł danych dla poleceń cmdlet usługi Power BI	MicrosoftPowerBIMgmt.Data
Moduł profilu dla poleceń cmdlet usługi Power BI	MicrosoftPowerBIMgmt.Profile
Moduł Raporty dla usługi Power BI	MicrosoftPowerBIMgmt.Reports
Moduł Obszary robocze dla usługi Power BI	MicrosoftPowerBIMgmt.Workspaces

Obsługiwane środowiska i wersje programu PowerShell

• Windows PowerShell wersji 3.0 i nowszej z platformą .NET 4.7.1 lub nowszą.
• Program PowerShell Core (wersja 6) i nowszy na dowolnej platformie systemu operacyjnego obsługiwanej przez program PowerShell Core.

Instalacja

Polecenia cmdlet są dostępne w Galeria programu PowerShell i można je zainstalować w sesji programu PowerShell z podwyższonym poziomem uprawnień:

Install-Module -Name MicrosoftPowerBIMgmt

Opcjonalnie można zainstalować poszczególne moduły (na podstawie Twoich potrzeb) zamiast modułu zbiorczego, na przykład jeśli potrzebujesz tylko modułu Obszary robocze:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Jeśli masz starszą wersję, możesz zaktualizować do najnowszej wersji, uruchamiając polecenie:

Update-Module -Name MicrosoftPowerBIMgmt

Dezinstalacja

Jeśli chcesz odinstalować wszystkie polecenia cmdlet programu PowerShell usługi Power BI, uruchom następujące polecenie w sesji programu PowerShell z podwyższonym poziomem uprawnień:

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

Użycie

Dwa zakresy są obsługiwane przez polecenia cmdlet, które współdziałają z jednostkami usługi Power BI:

• Osoba jest używana do uzyskiwania dostępu do jednostek należących do bieżącego użytkownika.
• Organizacja jest używana do uzyskiwania dostępu do jednostek w całej firmie. Tylko administratorzy dzierżawy usługi Power BI mogą używać.

Jeśli parametr -Scope nie istnieje w poleceniu cmdlet, jednostka nie obsługuje interfejsu API administracyjnego.

Zaloguj się do usługi Power BI

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

Pobieranie obszarów roboczych

Pobieranie obszarów roboczych dla użytkownika. Domyślnie (tj. bez -First parametru) wyświetla pierwsze 100 obszarów roboczych przypisanych do użytkownika:

Get-PowerBIWorkspace

Użyj parametru , -All aby wyświetlić wszystkie obszary robocze przypisane do użytkownika:

Get-PowerBIWorkspace -All

Jeśli jesteś administratorem dzierżawy, możesz wyświetlić wszystkie obszary robocze w dzierżawie, dodając polecenie -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Aktualizowanie obszaru roboczego

Zaktualizuj nazwę lub opis obszaru roboczego użytkownika:

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

Dodawanie nowego użytkownika do obszaru roboczego

Dodaj użytkownika do danego obszaru roboczego:

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

Usuwanie użytkownika z danego obszaru roboczego

Usuń uprawnienia użytkownika z danego obszaru roboczego:

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

Uzyskiwanie stanu migracji obszaru roboczego

Uzyskaj stan migracji obszaru roboczego usługi Power BI:

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

Przywracanie obszaru roboczego

Aby wyświetlić usunięte obszary robocze jako administrator dzierżawy:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Przywracanie usuniętego obszaru roboczego:

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

Odzyskiwanie oddzielonego obszaru roboczego

Obszar roboczy zostanie oddzielony, gdy nie ma przypisanych administratorów. Jeśli jesteś administratorem dzierżawy, uruchom następujące polecenie, aby wyświetlić wszystkie oddzielone obszary robocze:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Aby rozwiązać ten problem, użyj:

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

Pobieranie raportów

Pobierz wszystkie raporty dla użytkownika:

Get-PowerBIReport

Jeśli jesteś administratorem dzierżawy, możesz wyświetlić wszystkie raporty w dzierżawie, przypisując -Scope Organizationpolecenie :

Get-PowerBIReport -Scope Organization

Pobieranie pulpitów nawigacyjnych

Pobieranie pulpitów nawigacyjnych dla użytkownika:

Get-PowerBIDashboard

Jeśli jesteś administratorem dzierżawy, możesz wyświetlić wszystkie pulpity nawigacyjne w dzierżawie, dodając polecenie -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Pobieranie kafelków

Pobieranie kafelków na pulpicie nawigacyjnym:

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

Pobieranie importu

Pobieranie importu usługi Power BI:

Get-PowerBIImport

Tworzenie raportu

Utwórz raport w usłudze Power BI, przekazując plik *.pbix:

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

Domyślnie raport jest umieszczany w obszarze Mój obszar roboczy użytkownika. Aby umieścić w innym obszarze roboczym, użyj -WorkspaceId parametrów or -Workspace :

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

Eksportowanie raportu

Wyeksportuj raport usługi Power BI do pliku *.pbix:

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

Jeśli obszar roboczy istnieje poza obszarem Mój obszar roboczy, wyeksportuj za pomocą parametru WorkspaceId or -Workspace :

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

Pobieranie zestawów danych

Pobieranie zestawów danych usługi Power BI:

Get-PowerBIDataset

Aktualizowanie trybu przechowywania zestawu danych

Ustaw zestaw danych usługi Power BI na korzystanie z usługi Premium Files w trybie przechowywania:

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

Pobieranie źródeł danych

Pobieranie źródeł danych usługi Power BI dla zestawu danych:

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

Pobieranie tabel

Pobierz tabele usługi Power BI zawarte w zestawie danych:

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

Wywoływanie interfejsu API REST usługi Power BI

W przypadku interfejs API usługi Power BI, które nie mają odpowiednich poleceń cmdlet, możesz ponownie użyć uwierzytelnionej sesji, Connect-PowerBIServiceAccount aby wysyłać niestandardowe żądania REST:

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)

Jeśli chcesz użyć sesji uwierzytelnionej poza programem PowerShell, pobierz token dostępu przy użyciu:

Get-PowerBIAccessToken -AsString

Rozwiązywanie problemów z błędami

Aby uzyskać więcej informacji o błędzie zwróconym z poleceń cmdlet, użyj polecenia cmdlet:

Resolve-PowerBIError -Last

Te informacje mogą być przydatne podczas otwierania biletów pomocy technicznej dla usługi Power BI.

Problemy i opinie

Jeśli znajdziesz jakiekolwiek usterki lub chcesz zobaczyć pewne funkcje zaimplementowane dla poleceń cmdlet programu PowerShell dla usługi Power BI, zgłoś problem.

Jeśli problem jest szerszy niż tylko polecenia cmdlet programu PowerShell, prześlij swoją opinię do Społeczność usługi Power BI lub oficjalnej witryny pomocy technicznej usługi Power BI.