Cmdlet di Microsoft Power BI per Windows PowerShell e PowerShell Core

Informazioni di riferimento su PowerShell per Microsoft Power BI. Qui sono disponibili risorse per i moduli di PowerShell destinati a Power BI.

Moduli di PowerShell

Di seguito è riportata una tabella dei moduli di PowerShell di Power BI illustrati in questo riferimento.

Descrizione	Nome del modulo	collegamento PowerShell Gallery
Modulo di rollup per i cmdlet di Power BI	MicrosoftPowerBIMgmt
modulo Amministrazione per i cmdlet di Power BI	MicrosoftPowerBIMgmt.Admin
Modulo Capacità per i cmdlet di Power BI	MicrosoftPowerBIMgmt.Capacities
Modulo dati per i cmdlet di Power BI	MicrosoftPowerBIMgmt.Data
Modulo profilo per i cmdlet di Power BI	MicrosoftPowerBIMgmt.Profile
Modulo Report per Power BI	MicrosoftPowerBIMgmt.Reports
Modulo Aree di lavoro per Power BI	MicrosoftPowerBIMgmt.Workspaces

Ambienti supportati e versioni di PowerShell

• Windows PowerShell v3.0 e versioni successive con .NET 4.7.1 o versione successiva.
• PowerShell Core (v6) e in qualsiasi piattaforma del sistema operativo supportata da PowerShell Core.

Installazione

I cmdlet sono disponibili in PowerShell Gallery e possono essere installati in una sessione di PowerShell con privilegi elevati:

Install-Module -Name MicrosoftPowerBIMgmt

Facoltativamente, è possibile installare singoli moduli (in base alle esigenze) anziché il modulo di rollup, ad esempio se si vuole solo il modulo Aree di lavoro:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Se si dispone di una versione precedente, è possibile eseguire l'aggiornamento alla versione più recente eseguendo:

Update-Module -Name MicrosoftPowerBIMgmt

Disinstallare

Per disinstallare tutti i cmdlet di Power BI PowerShell, eseguire quanto segue in una sessione di PowerShell con privilegi elevati:

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

Utilizzo

Due ambiti sono supportati dai cmdlet che interagiscono con le entità di Power BI:

• L'utente singolo viene usato per accedere alle entità che appartengono all'utente corrente.
• L'organizzazione viene usata per accedere alle entità nell'intera azienda. Solo gli amministratori tenant di Power BI possono usare.

Se il parametro -Scope non esiste nel cmdlet, l'entità non supporta un'API amministrativa.

Accedere a Power BI

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

Ottenere le aree di lavoro

Ottenere le aree di lavoro per l'utente. Per impostazione predefinita ,ad esempio senza -First parametro, vengono visualizzate le prime 100 aree di lavoro assegnate all'utente:

Get-PowerBIWorkspace

Usare il -All parametro per visualizzare tutte le aree di lavoro assegnate all'utente:

Get-PowerBIWorkspace -All

Gli amministratori tenant possono visualizzare tutte le aree di lavoro nel tenant aggiungendo -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Aggiornare un’area di lavoro

Aggiornare il nome o la descrizione dell'area di lavoro di un utente:

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

Aggiungere un nuovo utente a un'area di lavoro

Aggiungere un utente a una determinata area di lavoro:

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

Rimuovere un utente da una determinata area di lavoro

Rimuovere le autorizzazioni dell'utente da una determinata area di lavoro:

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

Ottenere lo stato della migrazione dell'area di lavoro

Ottenere lo stato di migrazione dell'area di lavoro di Power BI:

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

Ripristinare un'area di lavoro

Per visualizzare le aree di lavoro eliminate come amministratore tenant:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Ripristinare un'area di lavoro eliminata:

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

Ripristinare un'area di lavoro orfana

Un'area di lavoro diventa orfana quando non ha amministratori assegnati. Se si è un amministratore tenant, eseguire quanto segue per visualizzare tutte le aree di lavoro orfane:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Per risolvere il problema, usare:

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

Ottenere report

Ottenere tutti i report per l'utente:

Get-PowerBIReport

Gli amministratori tenant possono visualizzare tutti i report nel tenant assegnando -Scope Organization:

Get-PowerBIReport -Scope Organization

Ottenere dashboard

Ottenere dashboard per l'utente:

Get-PowerBIDashboard

Gli amministratori tenant possono visualizzare tutti i dashboard nel tenant aggiungendo -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Ottenere riquadri

Ottenere riquadri all'interno di un dashboard:

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

Ottenere le importazioni

Ottenere le importazioni di Power BI:

Get-PowerBIImport

Creare un report

Creare un report in Power BI caricando un file *.pbix:

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

Per impostazione predefinita, il report viene inserito nell'area di lavoro personale dell'utente. Per posizionare in un'area di lavoro diversa, usare i -WorkspaceId parametri o -Workspace :

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

Esportare un report

Esportare un report di Power BI nel file *.pbix:

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

Se l'area di lavoro esiste all'esterno dell'area di lavoro personale, esportare con il WorkspaceId parametro o -Workspace :

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

Recupera set di dati

Ottenere i set di dati di Power BI:

Get-PowerBIDataset

Aggiornare la modalità di archiviazione del set di dati

Impostare il set di dati di Power BI per l'uso di File Premium per la modalità di archiviazione:

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

Ottenere origini dati

Ottenere origini dati di Power BI per un set di dati:

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

Ottieni tabelle

Ottenere le tabelle di Power BI contenute in un set di dati:

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

Chiamare l'API REST di Power BI

Per API Power BI che non dispone dei cmdlet corrispondenti, è possibile riutilizzare la sessione autenticata da Connect-PowerBIServiceAccount per effettuare richieste REST personalizzate:

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)

Se si vuole usare la sessione autenticata all'esterno di PowerShell, ottenere il token di accesso usando:

Get-PowerBIAccessToken -AsString

Risoluzione dei problemi

Per ottenere altre informazioni su un errore restituito dai cmdlet, usare:

Resolve-PowerBIError -Last

Queste informazioni possono essere utili per l'apertura di ticket di supporto per Power BI.

Problemi e feedback

Se vengono rilevati bug o si desidera visualizzare alcune funzionalità implementate per i cmdlet di PowerShell per Power BI, segnalare un problema.

Se il problema è più ampio rispetto ai cmdlet di PowerShell, inviare commenti e suggerimenti al Community di Power BI o al sito di supporto ufficiale di Power BI.