Freigeben über

Get-PowerBIWorkspace

Modul:
MicrosoftPowerBIMgmt.Workspaces Module

Gibt eine Liste von Power BI-Arbeitsbereichen zurück.

Syntax

List (Standardwert) 

Get-PowerBIWorkspace
    [-Scope <PowerBIUserScope>]
    [-Filter <String>]
    [-User <String>]
    [-Deleted]
    [-Orphaned]
    [-Type <WorkspaceType>]
    [-First <Int32>]
    [-Skip <Int32>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

Id 

Get-PowerBIWorkspace
    -Id <Guid>
    [-Scope <PowerBIUserScope>]
    [-Type <WorkspaceType>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

Name 

Get-PowerBIWorkspace
    -Name <String>
    [-Scope <PowerBIUserScope>]
    [-Type <WorkspaceType>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

All 

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 und -Skip können mit diesem Parameter nicht verwendet werden.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

All
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Deleted

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

List
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
All
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Filter

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

List
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
All
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-First

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

Parametereigenschaften

Typ:Int32
Standardwert:100
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Nach oben

Parametersätze

List
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

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

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Gruppen-ID, WorkspaceId

Parametersätze

Id
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Include

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

Parametereigenschaften

Typ:

ArtifactType[]

Standardwert:None
Zulässige Werte:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Erweitern

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Name
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Orphaned

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

List
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
All
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PowerBIUserScope
Standardwert:None
Zulässige Werte:Individual, Organization
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Skip

Überspringt den ersten Satz von Ergebnissen.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

List
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Type

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

Parametereigenschaften

Typ:WorkspaceType
Standardwert:None
Zulässige Werte:Workspace, Group, PersonalGroup
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

List
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Name
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Id
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
All
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-User

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

List
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
All
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.Collections.Generic.IEnumerable`1