Invoke-PowerBIRestMethod

Modul:

MicrosoftPowerBIMgmt.Profile Module

Spustí volání REST do služby Power BI se zadanou adresou URL a textem.

Syntax

Default (Výchozí)

Invoke-PowerBIRestMethod
    -Url <String>
    -Method <PowerBIWebRequestMethod>
    [-Body <String>]
    [-OutFile <String>]
    [-ContentType <String>]
    [-Headers <Hashtable>]
    [-TimeoutSec <Int32>]
    [-Organization <String>]
    [-Version <String>]
    [<CommonParameters>]

Description

Vyvolá požadavek REST na službu Power BI pomocí profilu, se kterým jste přihlášení. Příkaz REST lze zadat pomocí parametru -Method. Parametr -Body je vyžadován pro příkazy POST, PUT a PATCH. 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:\> Invoke-PowerBIRestMethod -Url 'groups' -Method Get

Vyvolá adresu URL https://api.powerbi.com/v1.0/myorg/groups metodou GET\slovesem.

Parametry

-Body

Text požadavku, označovaný také jako obsah. To je volitelné, pokud není metoda požadavku POST, PUT nebo PATCH.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ContentType

Typ obsahu, který se má zadat v hlavičce požadavku. Výchozí hodnota je application/json.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Headers

Volitelné hlavičky, které se mají zahrnout do požadavku.

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Method

Typ metody požadavku HTTP \verb, který se má provést s voláním.

Vlastnosti parametru

Typ:	PowerBIWebRequestMethod
Default value:	None
Přípustné hodnoty:	Get, Post, Delete, Put, Patch, Options
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Organization

Název organizace nebo identifikátor GUID tenanta, který se má zahrnout do adresy URL. Výchozí hodnota je myorg.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-OutFile

Výstupní soubor pro zápis obsahu odpovědi do. Zadaná cesta k souboru nesmí existovat.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-TimeoutSec

Určuje, jak dlouho může požadavek čekat, než vyprší časový limit. Zadejte hodnotu v sekundách. Zadání hodnoty 0 určuje neurčitý časový limit.

Vlastnosti parametru

Typ:	Int32
Default value:	100
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Url

Relativní nebo absolutní adresa URL entity Power BI, ke které chcete získat přístup. Pokud například chcete získat přístup k https://api.powerbi.com/v1.0/myorg/groups, zadejte "skupiny" nebo předejte celou adresu URL.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Version

Verze rozhraní API, která se má zahrnout do adresy URL. Výchozí hodnota je v1.0. Ignorováno, pokud je -Url absolutní adresou URL.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Výstupy

System.Object