Sdílet prostřednictvím


Get-PowerBIWorkspace

Vrátí seznam pracovních prostorů Power BI.

Syntaxe

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

Načte seznam pracovních prostorů Power BI, které odpovídají zadaným kritériím a oboru hledání. Ve výchozím nastavení (bez parametru -First) zobrazuje prvních 100 pracovních prostorů přiřazených uživateli. Pomocí -First a -Skip můžete načíst více pracovních prostorů nebo použít -All k vrácení všech pracovních prostorů. Parametr -First lze použít k vrácení maximálně 5 000 pracovních prostorů. Před spuštěním tohoto příkazu se ujistěte, že se přihlašujete pomocí connect-PowerBIServiceAccount.

Příklady

Příklad 1

PS C:\> Get-PowerBIWorkspace

Vrátí prvních 100 pracovních prostorů Power BI, ke kterým je volající uživatel přiřazen (-Scope jednotlivce).

Příklad 2

PS C:\> Get-PowerBIWorkspace -All

Vrátí všechny pracovní prostory Power BI, ke kterým je volající uživatel přiřazen.

Příklad 3

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

Vrátí pracovní prostor s názvem Contoso Sales (nerozlišující malá a velká písmena s tolowerem) v organizaci uživatele.

Příklad 3

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

Vrátí všechny pracovní prostory Power BI spolu se souvisejícími sestavami, řídicími panely, datovými sadami, toky dat a sešity v organizaci uživatele.

Parametry

-All

Označuje, že se mají zobrazit všechny pracovní prostory. -First a -Skip nelze s tímto parametrem použít.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Deleted

Označuje, že se mají zobrazit jenom odstraněné pracovní prostory. Podporuje se pouze při zadání -Scope organizace.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Filter

Filtr OData, rozlišují se malá a velká písmena (názvy elementů začínají malými písmeny).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-First

První (horní) seznam výsledků Tato hodnota je ve výchozím nastavení 100.

Typ:Int32
Aliasy:Top
Position:Named
Default value:100
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

ID pracovního prostoru, který se má vrátit.

Typ:Guid
Aliasy:GroupId, WorkspaceId
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Include

Načte související artefakty přidružené k pracovnímu prostoru Power BI. K dispozici pouze v případech, kdy -Scope je organizace.

Typ:ArtifactType[]
Aliasy:Expand
Přípustné hodnoty:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název pracovního prostoru, který se má vrátit, pokud existuje s tímto názvem. Vyhledávání bez rozlišování velkých a malých písmen

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Orphaned

Označuje, že se mají zobrazit pouze osamocené pracovní prostory. Podporuje se pouze při zadání -Scope organizace.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Scope

Označuje rozsah volání. Jednotlivec vrátí pouze pracovní prostory přiřazené volajícímu; Organizace vrátí všechny pracovní prostory v rámci tenanta (musí být správcem, který se má zahájit). Jednotlivec je výchozí.

Typ:PowerBIUserScope
Přípustné hodnoty:Individual, Organization
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Skip

Přeskočí první sadu výsledků.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Type

Typ pracovního prostoru, který se má vrátit. Hledání s rozlišováním velkých a velkých písmen

Typ:WorkspaceType
Přípustné hodnoty:Workspace, Group, PersonalGroup
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-User

Vyfiltrujte pracovní prostory tak, aby zobrazovaly ty, které uživatel obsahuje. K dispozici pouze v případech, kdy -Scope je organizace.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

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