Delen via

Invoke-PowerBIRestMethod

  • Referentie
Module:
MicrosoftPowerBIMgmt.Profile

Voert een REST-aanroep uit naar de Power BI-service, met de opgegeven URL en hoofdtekst.

Syntaxis

Invoke-PowerBIRestMethod
      -Url <String>
      -Method <PowerBIWebRequestMethod>
      [-Body <String>]
      [-OutFile <String>]
      [-ContentType <String>]
      [-Headers <Hashtable>]
      [-TimeoutSec <Int32>]
      [-Organization <String>]
      [-Version <String>]
      [<CommonParameters>]

Description

Roept een REST-aanvraag aan voor de Power BI-service met behulp van het profiel waarmee u bent aangemeld. Het REST-werkwoord kan worden opgegeven met behulp van de parameter -Method. De parameter -Body is vereist voor de werkwoorden POST, PUT en PATCH. Voordat u deze opdracht uitvoert, moet u zich aanmelden met Connect-PowerBIServiceAccount.

Voorbeelden

Voorbeeld 1

PS C:\> Invoke-PowerBIRestMethod -Url 'groups' -Method Get

Roept de URL-https://api.powerbi.com/v1.0/myorg/groups aan met de GET-methode\werkwoord.

Parameters

-Body

Hoofdtekst van de aanvraag, ook wel bekend als inhoud. Dit is optioneel, tenzij de aanvraagmethode POST, PUT of PATCH is.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ContentType

Inhoudstype dat moet worden opgegeven in de header voor de aanvraag. De standaardwaarde is 'application/json'.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Headers

Optionele headers die moeten worden opgenomen in de aanvraag.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Method

Type HTTP-aanvraagmethode\werkwoord dat moet worden uitgevoerd met de aanroep.

Type:PowerBIWebRequestMethod
Geaccepteerde waarden:Get, Post, Delete, Put, Patch, Options
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Organization

Organisatienaam of tenant-GUID die moet worden opgenomen in de URL. De standaardwaarde is 'myorg'.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OutFile

Uitvoerbestand voor het schrijven van de antwoordinhoud naar. Het opgegeven bestandspad mag niet bestaan.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeoutSec

Hiermee geeft u op hoe lang de aanvraag in behandeling kan zijn voordat er een time-out optreedt. Voer een waarde in seconden in. Als u een waarde van 0 invoert, wordt een onbepaalde time-out opgegeven.

Type:Int32
Position:Named
Default value:100
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Url

Relatieve of absolute URL van de Power BI-entiteit die u wilt openen. Als u bijvoorbeeld toegang wilt krijgen tot https://api.powerbi.com/v1.0/myorg/groups, geeft u 'groepen' op of geeft u de volledige URL door.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Version

De versie van de API die moet worden opgenomen in de URL. De standaardwaarde is v1.0. Genegeerd als -Url een absolute URL is.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

System.Object

Notities