Invoke-PowerBIRestMethod
Esegue una chiamata REST alla servizio Power BI, con l'URL e il corpo specificati.
Sintassi
Invoke-PowerBIRestMethod
-Url <String>
-Method <PowerBIWebRequestMethod>
[-Body <String>]
[-OutFile <String>]
[-ContentType <String>]
[-Headers <Hashtable>]
[-TimeoutSec <Int32>]
[-Organization <String>]
[-Version <String>]
[<CommonParameters>]
Descrizione
Richiama una richiesta REST rispetto al servizio Power BI usando il profilo con cui si esegue l'accesso. Il verbo REST può essere specificato usando il parametro -Method. Il parametro -Body è necessario per i verbi POST, PUT e PATCH. Prima di eseguire questo comando, assicurarsi di accedere usando Connect-PowerBIServiceAccount.
Esempio
Esempio 1
PS C:\> Invoke-PowerBIRestMethod -Url 'groups' -Method Get
Richiama l'URL https://api.powerbi.com/v1.0/myorg/groups con il metodo GET\verbo.
Parametri
-Body
Corpo della richiesta, noto anche come contenuto. Questo è facoltativo a meno che il metodo di richiesta non sia POST, PUT o PATCH.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentType
Tipo di contenuto da specificare all'interno dell'intestazione per la richiesta. Il valore predefinito è 'application/json'.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Headers
Intestazioni facoltative da includere con la richiesta.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Method
Tipo di metodo di richiesta HTTP\verbo da eseguire con la chiamata.
Type: | PowerBIWebRequestMethod |
Accepted values: | Get, Post, Delete, Put, Patch, Options |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Organization
Nome organizzazione o GUID tenant da includere nell'URL. Il valore predefinito è 'myorg'.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutFile
File di output per la scrittura del contenuto della risposta a. Il percorso file specificato non deve esistere.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Specifica la durata della richiesta in sospeso prima del timeout. Immettere un valore in secondi. L'immissione di un valore pari a 0 specifica un timeout indefinito.
Type: | Int32 |
Position: | Named |
Default value: | 100 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Url
URL relativo o assoluto dell'entità di Power BI a cui si vuole accedere. Ad esempio, se si vuole accedere https://api.powerbi.com/v1.0/myorg/groupsa , specificare "gruppi" o passare l'intero URL.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Versione dell'API da includere nell'URL. Il valore predefinito è 'v1.0'. Ignorato se -URL è un URL assoluto.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
None
Output
System.Object