Cmdlet di Microsoft Power BI per Windows PowerShell e PowerShell Core

Articolo
05/12/2023

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.

Condividi tramite