Get-PowerBIWorkspace

Module:

MicrosoftPowerBIMgmt.Workspaces

Retourne une liste d’espaces de travail Power BI.

Syntaxe

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

Récupère une liste d’espaces de travail Power BI qui correspondent aux critères de recherche et à l’étendue spécifiés. Par défaut (sans paramètre -First), il affiche les 100 premiers espaces de travail affectés à l’utilisateur. Utilisez -First et -Skip pour extraire plus d’espaces de travail ou utiliser -All pour retourner tous les espaces de travail. Le paramètre -First peut être utilisé pour retourner au maximum 5 000 espaces de travail. Avant d’exécuter cette commande, veillez à vous connecter à l’aide de Connect-PowerBIServiceAccount.

Exemples

Exemple 1

PS C:\> Get-PowerBIWorkspace

Retourne les 100 premiers espaces de travail Power BI auxquels l’utilisateur appelant est affecté (-Scope Individuel).

Exemple 2

PS C:\> Get-PowerBIWorkspace -All

Retourne tous les espaces de travail Power BI auxquels l’utilisateur appelant est affecté.

Exemple 3

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

Retourne un espace de travail nommé « Contoso Sales » (qui ne respecte pas la casse avec la licence) au sein de l’organisation de l’utilisateur.

Exemple 3

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

Retourne tous les espaces de travail Power BI ainsi que les rapports, tableaux de bord, jeux de données, flux de données et classeurs au sein de l’organisation de l’utilisateur.

Paramètres

-All

Indique d’afficher tous les espaces de travail. -First et -Skip ne peuvent pas être utilisés avec ce paramètre.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Deleted

Indique d’afficher uniquement les espaces de travail supprimés. Prise en charge uniquement lorsque -Scope Organisation est spécifiée.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Filter

Filtre OData, respectant la casse (les noms d’éléments commencent en minuscules).

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-First

Première (première) liste de résultats. Cette valeur est par défaut 100.

Type:	Int32
Alias:	Top
Position:	Named
Valeur par défaut:	100
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Id

ID de l’espace de travail à retourner.

Type:	Guid
Alias:	GroupId, WorkspaceId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Include

Récupère les artefacts associés associés à l’espace de travail Power BI. Disponible uniquement lorsque -Scope est Organisation.

Type:	ArtifactType[]
Alias:	Expand
Valeurs acceptées:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

Nom de l’espace de travail à retourner s’il en existe un avec ce nom. Recherche non sensible à la casse.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Orphaned

Indique d’afficher uniquement les espaces de travail orphelins. Prise en charge uniquement lorsque -Scope Organisation est spécifiée.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Scope

Indique l’étendue de l’appel. L’individu retourne uniquement les espaces de travail affectés à l’appelant ; L’organisation retourne tous les espaces de travail au sein d’un locataire (doit être un administrateur pour lancer). L’individu est la valeur par défaut.

Type:	PowerBIUserScope
Valeurs acceptées:	Individual, Organization
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Skip

Ignore le premier ensemble de résultats.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Type

Type de l’espace de travail à retourner. Recherche sensible à la casse.

Type:	WorkspaceType
Valeurs acceptées:	Workspace, Group, PersonalGroup
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-User

Filtrez les espaces de travail pour afficher ceux dans lesquels l’utilisateur est contenu. Disponible uniquement lorsque -Scope est Organisation.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

None

Sorties

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