Get-PowerBIWorkspace

Módulo:

MicrosoftPowerBIMgmt.Workspaces

Retorna uma lista de espaços de trabalho do Power BI.

Sintaxe

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 uma lista de espaços de trabalho do Power BI que correspondem aos critérios de pesquisa e ao escopo especificados. Por padrão (sem -First parâmetro), ele mostra os primeiros 100 espaços de trabalho atribuídos ao usuário. Use -First e -Skip para buscar mais espaços de trabalho ou use -All para retornar todos os espaços de trabalho. O parâmetro -First pode ser usado para retornar no máximo 5000 espaços de trabalho. Antes de executar este comando, certifique-se de que inicia sessão utilizando Connect-PowerBIServiceAccount.

Exemplos

Exemplo 1

PS C:\> Get-PowerBIWorkspace

Retorna os primeiros 100 espaços de trabalho do Power BI aos quais o usuário chamador está atribuído (-Scope Individual).

Exemplo 2

PS C:\> Get-PowerBIWorkspace -All

Retorna todos os espaços de trabalho do Power BI aos quais o usuário chamador está atribuído.

Exemplo 3

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

Retorna um espaço de trabalho chamado 'Contoso Sales' (sem diferenciação de maiúsculas e minúsculas com tolower) dentro da organização do usuário.

Exemplo 3

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

Retorna todos os espaços de trabalho do Power BI juntamente com relatórios, painéis, conjuntos de dados, fluxos de dados e pastas de trabalho relacionados dentro da organização do usuário.

Parâmetros

-All

Indica para mostrar todos os espaços de trabalho. -Primeiro e -Skip não podem ser usados com este parâmetro.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Deleted

Indica para mostrar apenas espaços de trabalho excluídos. Suportado apenas quando -Scope Organização é especificada.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Filter

Filtro OData, diferencia maiúsculas de minúsculas (os nomes dos elementos começam em minúsculas).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-First

Primeira (topo) lista de resultados. O padrão desse valor é 100.

Tipo:	Int32
Aliases:	Top
Position:	Named
Default value:	100
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Id

ID do espaço de trabalho a ser retornado.

Tipo:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Include

Recupera artefatos relacionados associados ao espaço de trabalho do Power BI. Disponível apenas quando -Scope é Organização.

Tipo:	ArtifactType[]
Aliases:	Expand
Valores aceites:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Nome do espaço de trabalho a ser retornado se existir um com esse nome. Pesquisa sem diferenciação de maiúsculas e minúsculas.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Orphaned

Indica mostrar apenas espaços de trabalho órfãos. Suportado apenas quando -Scope Organização é especificada.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Scope

Indica o escopo da chamada. Individual retorna apenas espaços de trabalho atribuídos ao chamador; A organização retorna todos os espaços de trabalho dentro de um locatário (deve ser um administrador para iniciar). Individual é o padrão.

Tipo:	PowerBIUserScope
Valores aceites:	Individual, Organization
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Skip

Ignora o primeiro conjunto de resultados.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Type

Tipo de espaço de trabalho a ser retornado. Pesquisa sensível a maiúsculas e minúsculas

Tipo:	WorkspaceType
Valores aceites:	Workspace, Group, PersonalGroup
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-User

Filtre espaços de trabalho para mostrar aqueles nos quais o usuário está contido. Disponível apenas quando -Scope é Organização.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

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