Get-PowerBIWorkspace

Módulo:

MicrosoftPowerBIMgmt.Workspaces

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

Syntax

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 y el ámbito de búsqueda especificados. De forma predeterminada (sin el parámetro -First) muestra las 100 primeras áreas de trabajo asignadas al usuario. Use -First y -Skip para capturar más áreas de trabajo o use -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 100 primeras á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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Deleted

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Filtro OData, con distinción entre mayúsculas y minúsculas (los nombres de elemento comienzan en minúsculas).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-First

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

Type:	Int32
Aliases:	Top
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Include

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

Type:	ArtifactType[]
Aliases:	Expand
Accepted values:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nombre del área de trabajo que se va a devolver si existe con ese nombre. Búsqueda sin distinción entre mayúsculas y minúsculas.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Orphaned

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Indica el ámbito de la llamada. Individual solo devuelve á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.

Type:	PowerBIUserScope
Accepted values:	Individual, Organization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Skip

Omite el primer conjunto de resultados.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

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

Type:	WorkspaceType
Accepted values:	Workspace, Group, PersonalGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-User

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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]]