Invoke-PowerBIRestMethod

Module:

MicrosoftPowerBIMgmt.Profile Module

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

Syntaxis

Default (Standaard)

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 inhoud genoemd. Dit is optioneel, tenzij de aanvraagmethode POST, PUT of PATCH is.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ContentType

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Headers

Optionele headers die moeten worden opgenomen in de aanvraag.

Parametereigenschappen

Type:	Hashtable
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Method

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

Parametereigenschappen

Type:	PowerBIWebRequestMethod
Default value:	None
Geaccepteerde waarden:	Get, Post, Delete, Put, Patch, Options
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Organization

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-OutFile

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	Int32
Default value:	100
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

System.Object