Get-PowerBIWorkspace

  • Referencia
Módulo:
MicrosoftPowerBIMgmt.Workspaces

Devuelve una lista de áreas de trabajo de Power BI.

Sintaxis

Get-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   [-Filter <String>]
   [-User <String>]
   [-Deleted]
   [-Orphaned]
   [-Type <WorkspaceType>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-Include <ArtifactType[]>]
   [<CommonParameters>]
Get-PowerBIWorkspace
   -Id <Guid>
   [-Scope <PowerBIUserScope>]
   [-Type <WorkspaceType>]
   [-Include <ArtifactType[]>]
   [<CommonParameters>]
Get-PowerBIWorkspace
   -Name <String>
   [-Scope <PowerBIUserScope>]
   [-Type <WorkspaceType>]
   [-Include <ArtifactType[]>]
   [<CommonParameters>]
Get-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   [-Filter <String>]
   [-User <String>]
   [-Deleted]
   [-Orphaned]
   [-Type <WorkspaceType>]
   [-Include <ArtifactType[]>]
   [-All]
   [<CommonParameters>]

Description

Recupera una lista de áreas de trabajo de Power BI que coinciden con los criterios de búsqueda y el ámbito especificados. De forma predeterminada (sin -First parámetro) muestra las primeras 100 áreas de trabajo asignadas al usuario. Use -First y -Skip para capturar más áreas de trabajo o usar -All para devolver todas las áreas de trabajo. El parámetro -First se puede usar para devolver como máximo 5000 áreas de trabajo. Antes de ejecutar este comando, asegúrese de iniciar sesión con Connect-PowerBIServiceAccount.

Ejemplos

Ejemplo 1

PS C:\> Get-PowerBIWorkspace

Devuelve las primeras 100 áreas de trabajo de Power BI a las que se asigna el usuario que realiza la llamada (-Scope individual).

Ejemplo 2

PS C:\> Get-PowerBIWorkspace -All

Devuelve todas las áreas de trabajo de Power BI a las que se asigna el usuario que realiza la llamada.

Ejemplo 3

PS C:\> Get-PowerBIWorkspace -Scope Organization -Filter "tolower(name) eq 'contoso sales'"

Devuelve un área de trabajo denominada "Contoso Sales" (no distingue mayúsculas de minúsculas con tolower) dentro de la organización del usuario.

Ejemplo 3

PS C:\> Get-PowerBIWorkspace -Scope Organization -Include All

Devuelve todas las áreas de trabajo de Power BI junto con informes, paneles, conjuntos de datos, flujos de datos y libros relacionados dentro de la organización del usuario.

Parámetros

-All

Indica que se muestran todas las áreas de trabajo. -First y -Skip no se pueden usar con este parámetro.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Deleted

Indica que solo se muestran las áreas de trabajo eliminadas. Solo se admite cuando se especifica -Scope Organización.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Filter

Filtro OData, distingue mayúsculas de minúsculas (los nombres de elemento comienzan en minúsculas).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-First

Primera lista (superior) de resultados. Este valor tiene como valor predeterminado 100.

Tipo:Int32
Alias:Top
Posición:Named
Valor predeterminado:100
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Identificador del área de trabajo que se va a devolver.

Tipo:Guid
Alias:GroupId, WorkspaceId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Include

Recupera artefactos relacionados asociados al área de trabajo de Power BI. Solo está disponible cuando -Scope es Organización.

Tipo:ArtifactType[]
Alias:Expand
Valores aceptados:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Nombre del área de trabajo que se va a devolver si existe con ese nombre. Búsqueda que no distingue mayúsculas de minúsculas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Orphaned

Indica que solo se muestran áreas de trabajo huérfanas. Solo se admite cuando se especifica -Scope Organización.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

Indica el ámbito de la llamada. Individual devuelve solo áreas de trabajo asignadas al autor de la llamada; La organización devuelve todas las áreas de trabajo de un inquilino (debe ser un administrador para iniciar). Individual es el valor predeterminado.

Tipo:PowerBIUserScope
Valores aceptados:Individual, Organization
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Skip

Omite el primer conjunto de resultados.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Type

Tipo del área de trabajo que se va a devolver. Búsqueda con distinción entre mayúsculas y minúsculas.

Tipo:WorkspaceType
Valores aceptados:Workspace, Group, PersonalGroup
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-User

Filtre las áreas de trabajo para mostrar las que contiene el usuario. Solo está disponible cuando -Scope es Organización.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Collections.Generic.IEnumerable`1[[Microsoft.PowerBI.Common.Api.Workspaces.Workspace, Microsoft.PowerBI.Common.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]