Get-PowerBIWorkspace

Módulo:

MicrosoftPowerBIMgmt.Workspaces

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

Exemplos

Exemplo 1

PS C:\> Get-PowerBIWorkspace

Devolve os primeiros 100 espaços de trabalho power BI a que o utilizador chama é atribuído (-Scope Individual).

Exemplo 2

PS C:\> Get-PowerBIWorkspace -All

Devolve todos os espaços de trabalho power BI a que o utilizador chama a chamada é atribuído.

Exemplo 3

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

Devolve um espaço de trabalho chamado 'Contoso Sales' (caso insensível com tolower) dentro da organização do utilizador.

Exemplo 3

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

Devolve todos os espaços de trabalho do Power BI juntamente com relatórios relacionados, dashboards, conjuntos de dados, fluxos de dados e livros de trabalho dentro da organização do utilizador.

Parâmetros

-All

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

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

-Deleted

Indica mostrar apenas espaços de trabalho apagados. Só suportado quando -Scope Organization é especificado.

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

-Filter

Filtro OData, sensível a maiúsculas (os nomes dos elementos começam em minúsculas).

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

-First

Primeira (top) lista de resultados. Este valor é de 100.

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

-Id

Identificação do espaço de trabalho para voltar.

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

-Include

Recupera artefactos relacionados associados ao espaço de trabalho Power BI. Só disponível quando -Scope is Organization.

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

-Name

Nome do espaço de trabalho para regressar se existir com esse nome. Caso insensível.

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

-Orphaned

Indica mostrar apenas espaços de trabalho órfãos. Só suportado quando -Scope Organization é especificado.

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

-Scope

Indica o alcance da chamada. As devoluções individuais apenas espaços de trabalho atribuídos ao chamador; A organização devolve todos os espaços de trabalho dentro de um inquilino (deve ser um administrador para iniciar). Individual é o padrão.

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

-Skip

Salta o primeiro conjunto de resultados.

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

-Type

Tipo de espaço de trabalho para voltar. Procura sensível a caso.

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

-User

Filtrar espaços de trabalho para mostrar aqueles que o utilizador está contido no interior. Só disponível quando -Scope is Organization.

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