Share via

Invoke-PowerBIRestMethod

  • Riferimento
Modulo:
MicrosoftPowerBIMgmt.Profile

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

Note