Get-PowerBIWorkspace

Module:

MicrosoftPowerBIMgmt.Workspaces

Retourne une liste d’espaces de travail Power BI.

Syntax

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 d’autres espaces de travail ou utilisez -All pour retourner tous les espaces de travail. Le paramètre -First peut être utilisé pour retourner au plus 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é (étendue individuelle).

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 le tolower) 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, dataflows et classeurs associés 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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Deleted

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

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

-Filter

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

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

-First

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

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

-Id

ID de l’espace de travail à retourner.

Type:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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[]
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

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

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

-Orphaned

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 à lancer). L’individu est la valeur par défaut.

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

-Skip

Ignore le premier ensemble de résultats.

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

-Type

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

Type:	WorkspaceType
Accepted values:	Workspace, Group, PersonalGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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]]