Get-PowerBIWorkspace

Returnerar en lista över Power BI-arbetsytor.

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

Hämtar en lista över Power BI-arbetsytor som matchar de angivna sökkriterierna och omfånget. Som standard (utan parametern -First) visas de första 100 arbetsytorna som tilldelats användaren. Använd -First och -Skip för att hämta fler arbetsytor eller använd -All för att returnera alla arbetsytor. Parametern -First kan användas för att returnera högst 5 000 arbetsytor. Innan du kör det här kommandot måste du logga in med Connect-PowerBIServiceAccount.

Exempel

Exempel 1

PS C:\> Get-PowerBIWorkspace

Returnerar de första 100 Power BI-arbetsytorna som den anropande användaren har tilldelats till (-Scope Individual).

Exempel 2

PS C:\> Get-PowerBIWorkspace -All

Returnerar alla Power BI-arbetsytor som den anropande användaren är tilldelad till.

Exempel 3

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

Returnerar en arbetsyta med namnet "Contoso Sales" (skiftlägesokänslig med tolower) i användarens organisation.

Exempel 3

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

Returnerar alla Power BI-arbetsytor tillsammans med relaterade rapporter, instrumentpaneler, datauppsättningar, dataflöden och arbetsböcker i användarens organisation.

Parametrar

-All

Anger för att visa alla arbetsytor. -First och -Skip kan inte användas med den här parametern.

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

-Deleted

Anger att endast borttagna arbetsytor ska visas. Stöds endast när -Scope Organization har angetts.

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

-Filter

OData-filter, skiftlägeskänsligt (elementnamn startar gemener).

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

-First

Första (översta) listan med resultat. Det här värdet är som standard 100.

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

-Id

ID för arbetsytan som ska returneras.

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

-Include

Hämtar relaterade artefakter som är associerade med Power BI-arbetsytan. Endast tillgängligt när -Scope är 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

Namnet på arbetsytan som ska returneras om det finns ett med det namnet. Skiftlägesokänslig sökning.

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

-Orphaned

Anger att endast överblivna arbetsytor ska visas. Stöds endast när -Scope Organization har angetts.

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

-Scope

Anger omfånget för anropet. Enskilda returnerar endast arbetsytor som tilldelats anroparen. Organisationen returnerar alla arbetsytor i en klientorganisation (måste vara administratör för att initiera). Enskild är standardinställningen.

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

-Skip

Hoppar över den första uppsättningen resultat.

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

-Type

Typ av arbetsyta som ska returneras. Skiftlägeskänslig sökning.

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

-User

Filtrera arbetsytor för att visa de som användaren finns i. Endast tillgängligt när -Scope är Organisation.

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

Indata

None

Utdata

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