Get-PowerBIWorkspace

Module:

MicrosoftPowerBIMgmt.Workspaces Module

Hiermee wordt een lijst met Power BI-werkruimten geretourneerd.

Syntaxis

List (Standaard)

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

Description

Hiermee haalt u een lijst met Power BI-werkruimten op die voldoen aan de opgegeven zoekcriteria en het opgegeven bereik. Standaard (zonder -First parameter) worden de eerste 100 werkruimten weergegeven die aan de gebruiker zijn toegewezen. Gebruik -First en -Skip om meer werkruimten op te halen of gebruik -All om alle werkruimten te retourneren. De parameter -First kan worden gebruikt om maximaal 5000 werkruimten te retourneren. Voordat u deze opdracht uitvoert, moet u zich aanmelden met Connect-PowerBIServiceAccount.

Voorbeelden

Voorbeeld 1

PS C:\> Get-PowerBIWorkspace

Retourneert de eerste 100 Power BI-werkruimten waaraan de aanroepende gebruiker is toegewezen (-Scope Individual).

Voorbeeld 2

PS C:\> Get-PowerBIWorkspace -All

Hiermee worden alle Power BI-werkruimten geretourneerd waaraan de aanroepende gebruiker is toegewezen.

Voorbeeld 3

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

Retourneert een werkruimte met de naam Contoso Sales (niet hoofdlettergevoelig met tolower) binnen de organisatie van de gebruiker.

Voorbeeld 3

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

Retourneert alle Power BI-werkruimten, samen met gerelateerde rapporten, dashboards, gegevenssets, gegevensstromen en werkmappen binnen de organisatie van de gebruiker.

Parameters

-All

Geeft aan dat alle werkruimten moeten worden weergegeven. -First en -Skip kunnen niet worden gebruikt met deze parameter.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

All

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Deleted

Geeft aan dat alleen verwijderde werkruimten worden weergegeven. Alleen ondersteund wanneer -Scope Organisatie is opgegeven.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

List

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

All

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Filter

OData-filter, hoofdlettergevoelig (elementnamen beginnen met kleine letters).

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

List

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

All

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-First

Eerste (bovenste) lijst met resultaten. Deze waarde is standaard ingesteld op 100.

Parametereigenschappen

Type:	Int32
Default value:	100
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Top

Parametersets

List

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Id

Id van de werkruimte die moet worden geretourneerd.

Parametereigenschappen

Type:	Guid
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	GroepId, WorkspaceId

Parametersets

Id

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Include

Hiermee worden gerelateerde artefacten opgehaald die zijn gekoppeld aan de Power BI-werkruimte. Alleen beschikbaar als -Scope organisatie is.

Parametereigenschappen

Type:	ArtifactType[]
Default value:	None
Geaccepteerde waarden:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Uitvouwen

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Name

De naam van de werkruimte die moet worden geretourneerd als er een bestaat met die naam. Niet hoofdlettergevoelig zoeken.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

Name

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Orphaned

Geeft aan dat alleen zwevende werkruimten worden weergegeven. Alleen ondersteund wanneer -Scope Organisatie is opgegeven.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

List

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

All

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Scope

Geeft het bereik van de aanroep aan. Persoon retourneert alleen werkruimten die zijn toegewezen aan de beller; Organisatie retourneert alle werkruimten binnen een tenant (moet een beheerder zijn om te initiëren). Individu is de standaardinstelling.

Parametereigenschappen

Type:	PowerBIUserScope
Default value:	None
Geaccepteerde waarden:	Individual, Organization
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Skip

Slaat de eerste set resultaten over.

Parametereigenschappen

Type:	Int32
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

List

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Type

Type van de werkruimte die moet worden geretourneerd. Hoofdlettergevoelige zoekopdracht.

Parametereigenschappen

Type:	WorkspaceType
Default value:	None
Geaccepteerde waarden:	Workspace, Group, PersonalGroup
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

List

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Name

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

Id

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

All

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-User

Filter werkruimten om de werkruimten weer te geven waarin de gebruiker zich bevindt. Alleen beschikbaar als -Scope organisatie is.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

List

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

All

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

System.Collections.Generic.IEnumerable`1