Get-PowerBIWorkspace

Modul:

MicrosoftPowerBIMgmt.Workspaces

Gibt eine Liste der Power BI-Arbeitsbereiche zurück.

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>]

Beschreibung

Ruft eine Liste der Power BI-Arbeitsbereiche ab, die den angegebenen Suchkriterien und -bereich entsprechen. Standardmäßig (ohne -First-Parameter) wird die ersten 100 Arbeitsbereiche angezeigt, die dem Benutzer zugewiesen sind. Verwenden Sie -First und -Skip, um weitere Arbeitsbereiche abzurufen oder -All zu verwenden, um alle Arbeitsbereiche zurückzugeben. Der -First-Parameter kann verwendet werden, um maximal 5000 Arbeitsbereiche zurückzugeben. Bevor Sie diesen Befehl ausführen, stellen Sie sicher, dass Sie sich mit Connect-PowerBIServiceAccount anmelden.

Beispiele

Beispiel 1

PS C:\> Get-PowerBIWorkspace

Gibt die ersten 100 Power BI-Arbeitsbereiche zurück, denen der aufrufende Benutzer zugewiesen ist (-Scope Individual).

Beispiel 2

PS C:\> Get-PowerBIWorkspace -All

Gibt alle Power BI-Arbeitsbereiche zurück, denen der Anrufbenutzer zugewiesen ist.

Beispiel 3

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

Gibt einen Arbeitsbereich namens "Contoso Sales" (Groß- und Kleinschreibung mit Tolower) innerhalb der Organisation des Benutzers zurück.

Beispiel 3

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

Gibt alle Power BI-Arbeitsbereiche zusammen mit verwandten Berichten, Dashboards, Datasets, Datenflüssen und Arbeitsmappen innerhalb der Organisation des Benutzers zurück.

Parameter

-All

Gibt an, alle Arbeitsbereiche anzuzeigen. -First and -Skip kann nicht mit diesem Parameter verwendet werden.

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

-Deleted

Gibt an, nur gelöschte Arbeitsbereiche anzuzeigen. Wird nur unterstützt, wenn die -Scope-Organisation angegeben wird.

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

-Filter

OData-Filter, Groß-/Kleinschreibung (Elementnamen starten Kleinbuchstaben).

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

-First

Erste (top) Liste der Ergebnisse. Dieser Wert ist auf 100 festgelegt.

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

-Id

ID des Arbeitsbereichs, der zurückgegeben werden soll.

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

-Include

Ruft verwandte Artefakte ab, die dem Power BI-Arbeitsbereich zugeordnet sind. Nur verfügbar, wenn -Scope Die Organisation ist.

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

Name des Arbeitsbereichs, der zurückgegeben werden soll, wenn eine person mit diesem Namen vorhanden ist. Groß-/Kleinschreibungssuche.

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

-Orphaned

Gibt an, nur verwaiste Arbeitsbereiche anzuzeigen. Wird nur unterstützt, wenn die -Scope-Organisation angegeben wird.

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

-Scope

Gibt den Bereich des Anrufs an. Einzelne Gibt nur Arbeitsbereiche zurück, die dem Anrufer zugewiesen sind; Organisation gibt alle Arbeitsbereiche innerhalb eines Mandanten zurück (muss ein Administrator sein, der initiiert werden soll). Einzelperson ist die Standardeinstellung.

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

-Skip

Überspringt den ersten Satz von Ergebnissen.

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

-Type

Typ des Arbeitsbereichs, der zurückgegeben werden soll. Groß-/Kleinschreibungssuche.

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

-User

Filtern Sie Arbeitsbereiche, um anzuzeigen, in denen der Benutzer enthalten ist. Nur verfügbar, wenn -Scope Die Organisation ist.

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

Eingaben

None

Ausgaben

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