Get-PowerBIWorkspace

Modulo:

MicrosoftPowerBIMgmt.Workspaces

Restituisce un elenco di aree di lavoro di Power BI.

Sintassi

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>]

Descrizione

Recupera un elenco di aree di lavoro di Power BI che corrispondono ai criteri di ricerca e all'ambito specificati. Per impostazione predefinita (senza -First parametro) mostra le prime 100 aree di lavoro assegnate all'utente. Usare -First e -Skip per recuperare più aree di lavoro o usare -All per restituire tutte le aree di lavoro. Il parametro -First può essere usato per restituire al massimo 5000 aree di lavoro. Prima di eseguire questo comando, assicurarsi di accedere usando Connect-PowerBIServiceAccount.

Esempio

Esempio 1

PS C:\> Get-PowerBIWorkspace

Restituisce le prime 100 aree di lavoro di Power BI a cui l'utente chiamante viene assegnato (-Scope Individual).

Esempio 2

PS C:\> Get-PowerBIWorkspace -All

Restituisce tutte le aree di lavoro di Power BI a cui viene assegnato l'utente chiamante.

Esempio 3

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

Restituisce un'area di lavoro denominata "Contoso Sales" (senza distinzione tra maiuscole e minuscole con tolower) all'interno dell'organizzazione dell'utente.

Esempio 3

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

Restituisce tutte le aree di lavoro di Power BI insieme a report, dashboard, set di dati, flussi di dati e cartelle di lavoro correlati all'interno dell'organizzazione dell'utente.

Parametri

-All

Indica di visualizzare tutte le aree di lavoro. -First e -Skip non possono essere usati con questo parametro.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Deleted

Indica di visualizzare solo le aree di lavoro eliminate. Supportato solo quando si specifica -Scope'organizzazione.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Filter

Filtro OData, con distinzione tra maiuscole e minuscole (i nomi degli elementi iniziano in lettere minuscole).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-First

Primo elenco (in alto) dei risultati. Il valore predefinito è 100.

Tipo:	Int32
Alias:	Top
Posizione:	Named
Valore predefinito:	100
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Id

ID dell'area di lavoro da restituire.

Tipo:	Guid
Alias:	GroupId, WorkspaceId
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Include

Recupera gli artefatti correlati associati all'area di lavoro di Power BI. Disponibile solo quando -Scope è Organization.

Tipo:	ArtifactType[]
Alias:	Expand
Valori accettati:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

Nome dell'area di lavoro da restituire se esistente con tale nome. Ricerca senza distinzione tra maiuscole e minuscole.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Orphaned

Indica di visualizzare solo le aree di lavoro orfane. Supportato solo quando si specifica -Scope'organizzazione.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Scope

Indica l'ambito della chiamata. Il singolo restituisce solo le aree di lavoro assegnate al chiamante; L'organizzazione restituisce tutte le aree di lavoro all'interno di un tenant (deve essere un amministratore per avviare). Individual è l'impostazione predefinita.

Tipo:	PowerBIUserScope
Valori accettati:	Individual, Organization
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Skip

Ignora il primo set di risultati.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Type

Tipo dell'area di lavoro da restituire. Ricerca con distinzione tra maiuscole e minuscole.

Tipo:	WorkspaceType
Valori accettati:	Workspace, Group, PersonalGroup
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-User

Filtrare le aree di lavoro per visualizzare quelle in cui è contenuto l'utente. Disponibile solo quando -Scope è Organization.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

None

Output

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