Invoke-PowerBIRestMethod

  • Riferimento
Modulo:
MicrosoftPowerBIMgmt.Profile

Esegue una chiamata REST al 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 sul servizio Power BI usando il profilo con cui si è connessi. È possibile specificare il verbo REST usando il parametro -Method. Il parametro -Body è obbligatorio 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 . Questa opzione è facoltativa a meno che il metodo di richiesta non sia POST, PUT o PATCH.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContentType

Tipo di contenuto da specificare all'interno dell'intestazione per la richiesta. Il valore predefinito è 'application/json'.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Headers

Intestazioni facoltative da includere con la richiesta.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Method

Tipo di metodo/verbo di richiesta HTTP da eseguire con la chiamata.

Tipo:PowerBIWebRequestMethod
Valori accettati:Get, Post, Delete, Put, Patch, Options
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Organization

Nome organizzazione o GUID tenant da includere nell'URL. Il valore predefinito è 'myorg'.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OutFile

File di output in cui scrivere il contenuto della risposta. Il percorso del file specificato non deve esistere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeoutSec

Specifica per quanto tempo la richiesta può essere in sospeso prima del timeout. Immettere un valore in secondi. Se si immette un valore pari a 0, viene specificato un timeout illimitato.

Tipo:Int32
Posizione:Named
Valore predefinito:100
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Url

URL relativo o assoluto dell'entità di Power BI a cui si vuole accedere. Ad esempio, se si vuole accedere a https://api.powerbi.com/v1.0/myorg/groups, specificare "gruppi" o passare l'intero URL.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Version

Versione dell'API da includere nell'URL. Il valore predefinito è 'v1.0'. Ignorato se -Url è un URL assoluto.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object

Note