Get-PowerBIWorkspace

  • Referencia
Modul:
MicrosoftPowerBIMgmt.Workspaces

A Power BI-munkaterületek listáját adja vissza.

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

Lekéri a megadott keresési feltételeknek és hatókörnek megfelelő Power BI-munkaterületek listáját. Alapértelmezés szerint (az -First paraméter nélkül) a felhasználóhoz rendelt első 100 munkaterületet jeleníti meg. Az -First és a -Skip parancsot használva több munkaterületet hívhat le, a -All parancsot pedig az összes munkaterület visszaadásához. Az -First paraméter legfeljebb 5000 munkaterület visszaadására használható. A parancs futtatása előtt győződjön meg arról, hogy a Connect-PowerBIServiceAccount használatával jelentkezik be.

Példák

1\. példa

PS C:\> Get-PowerBIWorkspace

Az első 100 Power BI-munkaterületet adja vissza, amelyhez a hívó felhasználó hozzá van rendelve (-Scope Individual).

2\. példa

PS C:\> Get-PowerBIWorkspace -All

Visszaadja az összes Olyan Power BI-munkaterületet, amelyhez a hívó felhasználó hozzá van rendelve.

3\. példa

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

Egy "Contoso Sales" nevű munkaterületet ad vissza (a kis- és nagybetűket nem megkülönböztető) a felhasználó szervezetén belül.

3\. példa

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

Visszaadja az összes Power BI-munkaterületet, valamint a kapcsolódó jelentéseket, irányítópultokat, adatkészleteket, adatfolyamokat és munkafüzeteket a felhasználó szervezetén belül.

Paraméterek

-All

Az összes munkaterület megjelenítését jelzi. A -First és a -Skip nem használható ezzel a paraméterrel.

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

-Deleted

Azt jelzi, hogy csak a törölt munkaterületek jelennek meg. Csak akkor támogatott, ha a -Scope Organization meg van adva.

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

-Filter

OData-szűrő, kis- és nagybetűk megkülönböztetése (az elemnevek kisbetűkkel kezdődnek).

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

-First

Az első (legfelső) találatlista. Ez az érték alapértelmezés szerint 100.

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

-Id

A visszaküldött munkaterület azonosítója.

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

-Include

Lekéri a Power BI-munkaterülethez társított kapcsolódó összetevőket. Csak akkor érhető el, ha a -Scope a Szervezet.

Type:ArtifactType[]
Aliases:Expand
Accepted values:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

A visszaadandó munkaterület neve, ha van ilyen nevű munkaterület. A kis- és nagybetűket nem megkülönböztető keresés.

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

-Orphaned

Azt jelzi, hogy csak az árva munkaterületek jelennek meg. Csak akkor támogatott, ha a -Scope Organization meg van adva.

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

-Scope

A hívás hatókörét jelzi. Az egyéni felhasználó csak a hívóhoz rendelt munkaterületeket adja vissza; A szervezet a bérlőn belüli összes munkaterületet visszaadja (a kezdeményezéshez rendszergazdának kell lennie). Az egyéni az alapértelmezett érték.

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

-Skip

Kihagyja az első találatkészletet.

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

-Type

A visszaküldött munkaterület típusa. Kis- és nagybetűk megkülönböztetése keresés.

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

-User

A munkaterületek szűrésével megjelenítheti a felhasználó által tartalmazott munkaterületeket. Csak akkor érhető el, ha a -Scope a Szervezet.

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

Bevitelek

None

Kimenetek

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