Get-PowerBIWorkspace

Modul:

MicrosoftPowerBIMgmt.Workspaces

Gibt eine Liste von Power BI-Arbeitsbereichen 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 von Power BI-Arbeitsbereichen ab, die den angegebenen Suchkriterien und dem angegebenen Bereich entsprechen. Standardmäßig (ohne -First Parameter) werden die ersten 100 Arbeitsbereiche angezeigt, die dem Benutzer zugewiesen sind. Verwenden Sie -First und -Skip, um weitere Arbeitsbereiche abzurufen, oder verwenden Sie -All, um alle Arbeitsbereiche zurückzugeben. Der parameter -First kann verwendet werden, um höchstens 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 aufrufende Benutzer zugewiesen ist.

Beispiel 3

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

Gibt einen Arbeitsbereich mit dem Namen "Contoso Sales" zurück (Groß-/Kleinschreibung ohne Berücksichtigung von Tolower) innerhalb der Organisation des Benutzers.

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, dass alle Arbeitsbereiche angezeigt werden. -First and -Skip cannot be used with this parameter.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Deleted

Gibt an, dass nur gelöschte Arbeitsbereiche angezeigt werden. Wird nur unterstützt, wenn -Scope Organisation angegeben wird.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Filter

OData-Filter, Groß-/Kleinschreibung beachten (Elementnamen beginnen mit Kleinbuchstaben).

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-First

Erste (oberste) Liste der Ergebnisse. Dieser Wert ist standardmäßig auf 100 festgelegt.

Typ:	Int32
Aliase:	Top
Position:	Named
Standardwert:	100
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Id

DIE ID des Arbeitsbereichs, der zurückgegeben werden soll.

Typ:	Guid
Aliase:	GroupId, WorkspaceId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Include

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

Typ:	ArtifactType[]
Aliase:	Expand
Zulässige Werte:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Name

Der Name des Arbeitsbereichs, der zurückgegeben werden soll, wenn er mit diesem Namen vorhanden ist. Suche ohne Groß-/Kleinschreibung.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Orphaned

Gibt an, dass nur verwaiste Arbeitsbereiche angezeigt werden. Wird nur unterstützt, wenn -Scope Organisation angegeben wird.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

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

Typ:	PowerBIUserScope
Zulässige Werte:	Individual, Organization
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Skip

Überspringt den ersten Satz von Ergebnissen.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Type

Typ des zurückzugebenden Arbeitsbereichs. Suche unter Beachtung der Groß-/Kleinschreibung.

Typ:	WorkspaceType
Zulässige Werte:	Workspace, Group, PersonalGroup
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-User

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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]]