Dela via

Get-PowerBIWorkspace

  • Referens
Modul:
MicrosoftPowerBIMgmt.Workspaces

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ökvillkoren och omfånget. Som standard (utan -First parameter) 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 Enskild).

Exempel 2

PS C:\> Get-PowerBIWorkspace -All

Returnerar alla Power BI-arbetsytor som den anropande användaren har tilldelats 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. -Först och -Skip kan inte användas med den här parametern.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Deleted

Anger att endast borttagna arbetsytor ska visas. Stöds endast när -Scope Organisation anges.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Filter

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-First

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

Typ:Int32
Alias:Top
Position:Named
Standardvärde:100
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

ID för arbetsytan som ska returneras.

Typ:Guid
Alias:GroupId, WorkspaceId
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Include

Hämtar relaterade artefakter som är associerade med Power BI-arbetsytan. Endast tillgängligt när -Scope är Organisation.

Typ:ArtifactType[]
Alias:Expand
Godkända värden:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Orphaned

Anger att endast överblivna arbetsytor ska visas. Stöds endast när -Scope Organisation anges.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:PowerBIUserScope
Godkända värden:Individual, Organization
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Skip

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

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Type

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

Typ:WorkspaceType
Godkända värden:Workspace, Group, PersonalGroup
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-User

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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]]