Get-PowerBIWorkspace
Retorna uma lista de workspaces do 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 workspaces do Power BI que correspondem aos critérios de pesquisa e ao escopo especificados. Por padrão (sem o parâmetro -First), ele mostra os primeiros 100 workspaces atribuídos ao usuário. Use -First e -Skip para buscar mais workspaces ou use -All para retornar todos os workspaces. O parâmetro -First pode ser usado para retornar no máximo 5.000 workspaces. Antes de executar esse comando, faça logon usando Connect-PowerBIServiceAccount.
Exemplos
Exemplo 1
PS C:\> Get-PowerBIWorkspace
Retorna os primeiros 100 workspaces do Power BI aos quais o usuário chamado é atribuído (-Indivíduo de Escopo).
Exemplo 2
PS C:\> Get-PowerBIWorkspace -All
Retorna todos os workspaces do Power BI aos quais o usuário chamado está atribuído.
Exemplo 3
PS C:\> Get-PowerBIWorkspace -Scope Organization -Filter "tolower(name) eq 'contoso sales'"
Retorna um workspace chamado 'Contoso Sales' (não diferencia maiúsculas de minúsculas com tolower) dentro da organização do usuário.
Exemplo 3
PS C:\> Get-PowerBIWorkspace -Scope Organization -Include All
Retorna todos os workspaces do Power BI junto com relatórios, dashboards, 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 workspaces. -First e -Skip não podem ser usados com esse parâmetro.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Deleted
Indica mostrar apenas workspaces excluídos. Só há suporte quando -Scope Organization é especificado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Filter
Filtro OData, diferencia maiúsculas de minúsculas (nomes de elementos iniciam minúsculas).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-First
Primeira lista (superior) de resultados. Esse valor é o padrão de 100.
Type: | Int32 |
Aliases: | Top |
Position: | Named |
Default value: | 100 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
ID do workspace a ser retornado.
Type: | Guid |
Aliases: | GroupId, WorkspaceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Recupera artefatos relacionados associados ao workspace do Power BI. Disponível somente quando -Escopo é Organização.
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
Nome do workspace a ser retornado se houver um com esse nome. Pesquisa sem diferenciação de maiúsculas de minúsculas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Orphaned
Indica mostrar apenas workspaces órfãos. Só há suporte quando -Scope Organization é especificado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Indica o escopo da chamada. Individual retorna apenas workspaces atribuídos ao chamador; A organização retorna todos os workspaces dentro de um locatário (deve ser um administrador a ser iniciado). Individual é o padrão.
Type: | PowerBIUserScope |
Accepted values: | Individual, Organization |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Skip
Ignora o primeiro conjunto de resultados.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Type
Tipo do workspace a ser retornado. Pesquisa confidencial de maiúsculas de 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
Filtrar workspaces para mostrar os quais o usuário está contido. Disponível somente quando -Escopo é Organização.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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]]
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de