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.
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.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
All
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Deleted
Indica para mostrar apenas espaços de trabalho excluídos. Suportado apenas quando -Scope Organização é especificada.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
List
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
All
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Filter
Filtro OData, diferencia maiúsculas de minúsculas (os nomes dos elementos começam em minúsculas).
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
List
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
All
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-First
Primeira (topo) lista de resultados. O padrão desse valor é 100.
Propriedades dos parâmetros
Tipo:
Int32
Default value:
100
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
Início
Conjuntos de parâmetros
List
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Id
ID do espaço de trabalho a ser retornado.
Propriedades dos parâmetros
Tipo:
Guid
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
Id do Grupo, WorkspaceId
Conjuntos de parâmetros
Id
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Include
Recupera artefatos relacionados associados ao espaço de trabalho do Power BI. Disponível apenas quando -Scope é Organização.
Propriedades dos parâmetros
Tipo:
ArtifactType[]
Default value:
None
Valores aceites:
Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
Expandir
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
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.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Name
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Orphaned
Indica mostrar apenas espaços de trabalho órfãos. Suportado apenas quando -Scope Organização é especificada.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
List
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
All
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
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.
Propriedades dos parâmetros
Tipo:
PowerBIUserScope
Default value:
None
Valores aceites:
Individual, Organization
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Skip
Ignora o primeiro conjunto de resultados.
Propriedades dos parâmetros
Tipo:
Int32
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
List
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Type
Tipo de espaço de trabalho a ser retornado. Pesquisa sensível a maiúsculas e minúsculas
Propriedades dos parâmetros
Tipo:
WorkspaceType
Default value:
None
Valores aceites:
Workspace, Group, PersonalGroup
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
List
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Name
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Id
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
All
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-User
Filtre espaços de trabalho para mostrar aqueles nos quais o usuário está contido. Disponível apenas quando -Scope é Organização.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
List
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
All
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Saídas
System.Collections.Generic.IEnumerable`1
Feedback
Esta página foi útil?
Não
Precisa de ajuda com este tema?
Quer experimentar usar o Ask Learn para esclarecer ou orientar este tema?