Sdílet prostřednictvím


Invoke-PowerBIRestMethod

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

Syntaxe

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.

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

-ContentType

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

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

-Headers

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

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

-Method

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

Typ:PowerBIWebRequestMethod
Přípustné hodnoty:Get, Post, Delete, Put, Patch, Options
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Organization

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

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

-OutFile

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Int32
Position:Named
Default value:100
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

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.Object

Poznámky