Condividi tramite

Get-PowerBIWorkspace

  • Riferimento
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 corrispondenti ai criteri di ricerca e all'ambito specificati. Per impostazione predefinita (senza il parametro -First), vengono visualizzate le prime 100 aree di lavoro assegnate all'utente. Usare -First e -Skip per recuperare altre 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.

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

-Deleted

Indica di visualizzare solo le aree di lavoro eliminate. Supportato solo quando viene specificato -Scope Organization.

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

-Filter

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

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

-First

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

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

-Id

ID dell'area di lavoro da restituire.

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

-Include

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

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 dell'area di lavoro da restituire se presente con tale nome. Ricerca senza distinzione tra maiuscole e minuscole.

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

-Orphaned

Indica di visualizzare solo le aree di lavoro orfane. Supportato solo quando viene specificato -Scope Organization.

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

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

-Skip

Ignora il primo set di risultati.

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

-Type

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

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

-User

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

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