Delen via

Get-PowerBIWorkspace

  • Referentie
Module:
MicrosoftPowerBIMgmt.Workspaces

Hiermee wordt een lijst met Power BI-werkruimten geretourneerd.

Syntaxis

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

Hiermee haalt u een lijst met Power BI-werkruimten op die voldoen aan de opgegeven zoekcriteria en het opgegeven bereik. Standaard (zonder -First parameter) worden de eerste 100 werkruimten weergegeven die aan de gebruiker zijn toegewezen. Gebruik -First en -Skip om meer werkruimten op te halen of gebruik -All om alle werkruimten te retourneren. De parameter -First kan worden gebruikt om maximaal 5000 werkruimten te retourneren. Voordat u deze opdracht uitvoert, moet u zich aanmelden met Connect-PowerBIServiceAccount.

Voorbeelden

Voorbeeld 1

PS C:\> Get-PowerBIWorkspace

Retourneert de eerste 100 Power BI-werkruimten waaraan de aanroepende gebruiker is toegewezen (-Scope Individual).

Voorbeeld 2

PS C:\> Get-PowerBIWorkspace -All

Hiermee worden alle Power BI-werkruimten geretourneerd waaraan de aanroepende gebruiker is toegewezen.

Voorbeeld 3

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

Retourneert een werkruimte met de naam Contoso Sales (niet hoofdlettergevoelig met tolower) binnen de organisatie van de gebruiker.

Voorbeeld 3

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

Retourneert alle Power BI-werkruimten, samen met gerelateerde rapporten, dashboards, gegevenssets, gegevensstromen en werkmappen binnen de organisatie van de gebruiker.

Parameters

-All

Geeft aan dat alle werkruimten moeten worden weergegeven. -First en -Skip kunnen niet worden gebruikt met deze parameter.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Deleted

Geeft aan dat alleen verwijderde werkruimten worden weergegeven. Alleen ondersteund wanneer -Scope Organisatie is opgegeven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Filter

OData-filter, hoofdlettergevoelig (elementnamen beginnen met kleine letters).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-First

Eerste (bovenste) lijst met resultaten. Deze waarde is standaard ingesteld op 100.

Type:Int32
Aliassen:Top
Position:Named
Default value:100
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Id van de werkruimte die moet worden geretourneerd.

Type:Guid
Aliassen:GroupId, WorkspaceId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Include

Hiermee worden gerelateerde artefacten opgehaald die zijn gekoppeld aan de Power BI-werkruimte. Alleen beschikbaar als -Scope organisatie is.

Type:ArtifactType[]
Aliassen:Expand
Geaccepteerde waarden:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

De naam van de werkruimte die moet worden geretourneerd als er een bestaat met die naam. Niet hoofdlettergevoelig zoeken.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Orphaned

Geeft aan dat alleen zwevende werkruimten worden weergegeven. Alleen ondersteund wanneer -Scope Organisatie is opgegeven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Geeft het bereik van de aanroep aan. Persoon retourneert alleen werkruimten die zijn toegewezen aan de beller; Organisatie retourneert alle werkruimten binnen een tenant (moet een beheerder zijn om te initiëren). Individu is de standaardinstelling.

Type:PowerBIUserScope
Geaccepteerde waarden:Individual, Organization
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Skip

Slaat de eerste set resultaten over.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Type

Type van de werkruimte die moet worden geretourneerd. Hoofdlettergevoelige zoekopdracht.

Type:WorkspaceType
Geaccepteerde waarden:Workspace, Group, PersonalGroup
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-User

Filter werkruimten om de werkruimten weer te geven waarin de gebruiker zich bevindt. Alleen beschikbaar als -Scope organisatie is.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

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