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