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.