Cmdlets de Microsoft Power BI para Windows PowerShell y PowerShell Core

Le damos la bienvenida a la referencia de PowerShell para Microsoft Power BI. Aquí encontrará recursos para los módulos de PowerShell destinados a Power BI.

Módulos de PowerShell

A continuación se muestra una tabla de los módulos de PowerShell de Power BI que se tratan en esta referencia.

Descripción	Nombre del módulo	Vínculo de la Galería de PowerShell
Módulo acumulativo para cmdlets de Power BI	NA
Módulo de administración para cmdlets de Power BI	MicrosoftPowerBIMgmt.Admin Module
Módulo de capacidades para cmdlets de Power BI	MicrosoftPowerBIMgmt.Capacities Module
Módulo de datos para cmdlets de Power BI	MicrosoftPowerBIMgmt.Data Module
Módulo de perfil para cmdlets de Power BI	MicrosoftPowerBIMgmt.Profile Module
Módulo de informes para Power BI	MicrosoftPowerBIMgmt.Reports Module
Módulo de áreas de trabajo para Power BI	MicrosoftPowerBIMgmt.Workspaces Module

Entornos compatibles y versiones de PowerShell

• Windows PowerShell v3.0 y versiones posteriores con .NET 4.7.1 o superior.
• PowerShell Core (v6) y versiones posteriores en cualquier plataforma de sistema operativo compatible con PowerShell Core.

Instalación

Los cmdlets están disponibles en la Galería de PowerShell y se pueden instalar en una sesión de PowerShell con privilegios elevados:

Install-Module -Name MicrosoftPowerBIMgmt

Opcionalmente, puede instalar módulos individuales (según sus necesidades) en lugar del módulo acumulativo, por ejemplo, si solo desea el módulo Espacios de trabajo:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

Si tiene una versión anterior, puede actualizar a la versión más reciente ejecutando:

Update-Module -Name MicrosoftPowerBIMgmt

Desinstalar

Si desea desinstalar todos los cmdlets de PowerShell de Power BI, ejecute lo siguiente en una sesión de PowerShell con privilegios elevados:

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

Uso

Los cmdlets que interactúan con las entidades de Power BI admiten dos ámbitos:

• Individual se utiliza para acceder a las entidades que pertenecen al usuario actual.
• La organización se utiliza para acceder a entidades de toda la empresa. Solo los administradores de inquilinos de Power BI pueden usar.

Si el parámetro -Scope no existe en el cmdlet, la entidad no admite una API administrativa.

Iniciar sesión en Power BI

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

Obtención de espacios de trabajo

Obtener espacios de trabajo para el usuario. De forma predeterminada (es decir, sin -First parámetro) muestra los primeros 100 espacios de trabajo asignados al usuario:

Get-PowerBIWorkspace

Utilice el -All parámetro para mostrar todos los espacios de trabajo asignados al usuario:

Get-PowerBIWorkspace -All

Si es un administrador de inquilinos, puede ver todas las áreas de trabajo de su inquilino agregando -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

Actualización de un área de trabajo

Actualice el nombre o la descripción del espacio de trabajo de un usuario:

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

Agregar un nuevo usuario a un espacio de trabajo

Agregar un usuario a un espacio de trabajo determinado:

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

Eliminar un usuario de un espacio de trabajo determinado

Eliminar los permisos de un usuario de un espacio de trabajo determinado:

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

Obtención del estado de migración del área de trabajo

Obtener el estado de migración del área de trabajo de Power BI:

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

Restauración de un área de trabajo

Para ver las áreas de trabajo eliminadas como administrador de inquilinos:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

Restaurar un espacio de trabajo eliminado:

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

Recuperación de un área de trabajo huérfana

Un área de trabajo queda huérfana cuando no tiene administradores asignados. Si es un administrador de inquilinos, ejecute lo siguiente para ver todas las áreas de trabajo huérfanas:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

Para corregir este problema, utilice:

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

Obtener informes

Obtener todos los informes para el usuario:

Get-PowerBIReport

Si es un administrador de inquilinos, puede ver todos los informes de su inquilino mediante la asignación -Scope Organization:

Get-PowerBIReport -Scope Organization

Obtener paneles

Obtener paneles para el usuario:

Get-PowerBIDashboard

Si es un administrador de inquilinos, puede ver todos los paneles de su inquilino agregando -Scope Organization:

Get-PowerBIDashboard -Scope Organization

Obtener mosaicos

Obtener iconos dentro de un panel:

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

Obtener importaciones

Obtención de importaciones de Power BI:

Get-PowerBIImport

Creación de un informe

Cree un informe en Power BI cargando un archivo *.pbix:

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

De forma predeterminada, el informe se coloca en Mi área de trabajo del usuario. Para colocarlo en un espacio de trabajo diferente, utilice los -WorkspaceId parámetros o -Workspace :

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

Exportar un informe

Exportar un informe de Power BI a un archivo *.pbix:

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

Si el espacio de trabajo existe fuera de Mi área de trabajo, expórtelo con el WorkspaceId parámetro o -Workspace :

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

Obtención de conjuntos de datos

Obtención de conjuntos de datos de Power BI:

Get-PowerBIDataset

Actualizar el modo de almacenamiento del conjunto de datos

Establezca el conjunto de datos de Power BI para usar Premium Files para el modo de almacenamiento:

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

Obtención de fuentes de datos

Obtención de orígenes de datos de Power BI para un conjunto de datos:

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

Obtener tablas

Obtención de tablas de Power BI contenidas en un conjunto de datos:

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

Llamada a la API REST de Power BI

En el caso de la API de Power BI que carece de cmdlets correspondientes, puede reutilizar la sesión autenticada desde Connect-PowerBIServiceAccount para realizar solicitudes REST personalizadas:

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)

Si desea usar la sesión autenticada fuera de PowerShell, obtenga el token de acceso mediante:

Get-PowerBIAccessToken -AsString

Solucionar errores

Para obtener más información sobre un error devuelto por los cmdlets, use:

Resolve-PowerBIError -Last

Esta información puede ser útil para abrir tickets de soporte técnico para Power BI.

Problemas y comentarios

Si encuentra algún error o desea ver cierta funcionalidad implementada para los cmdlets de PowerShell para Power BI, presente un problema.

Si el problema va más allá de los cmdlets de PowerShell, envíe sus comentarios a la comunidad de Power BI o al sitio oficial de soporte técnico de Power BI .