Condividi tramite

Get-PowerBIWorkspace

Modulo:
MicrosoftPowerBIMgmt.Workspaces Module

Restituisce un elenco di aree di lavoro di Power BI.

Sintassi

List (Impostazione predefinita) 

Get-PowerBIWorkspace
    [-Scope <PowerBIUserScope>]
    [-Filter <String>]
    [-User <String>]
    [-Deleted]
    [-Orphaned]
    [-Type <WorkspaceType>]
    [-First <Int32>]
    [-Skip <Int32>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

Id 

Get-PowerBIWorkspace
    -Id <Guid>
    [-Scope <PowerBIUserScope>]
    [-Type <WorkspaceType>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

Name 

Get-PowerBIWorkspace
    -Name <String>
    [-Scope <PowerBIUserScope>]
    [-Type <WorkspaceType>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

All 

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

All
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Deleted

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

List
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
All
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Filter

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

List
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
All
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-First

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

Proprietà dei parametri

Tipo:Int32
Valore predefinito:100
Supporta i caratteri jolly:False
DontShow:False
Alias:In alto

Set di parametri

List
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

ID dell'area di lavoro da restituire.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ID del Gruppo, WorkspaceId

Set di parametri

Id
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Include

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

Proprietà dei parametri

Tipo:

ArtifactType[]

Valore predefinito:None
Valori accettati:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Supporta i caratteri jolly:False
DontShow:False
Alias:Espandi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Name
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Orphaned

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

List
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
All
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:PowerBIUserScope
Valore predefinito:None
Valori accettati:Individual, Organization
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Skip

Ignora il primo set di risultati.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

List
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Type

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

Proprietà dei parametri

Tipo:WorkspaceType
Valore predefinito:None
Valori accettati:Workspace, Group, PersonalGroup
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

List
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Name
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Id
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
All
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-User

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

List
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
All
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

System.Collections.Generic.IEnumerable`1