Invoke-PowerBIRestMethod

Modul:

MicrosoftPowerBIMgmt.Profile

Kör ett REST-anrop till Power BI-tjänsten med angiven URL och brödtext.

Syntax

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

Description

Anropar en REST-begäran mot Power BI-tjänsten med den profil som du är inloggad med. REST-verbet kan anges med parametern -Method. Parametern -Body krävs för verben POST, PUT och PATCH. Innan du kör det här kommandot måste du logga in med Connect-PowerBIServiceAccount.

Exempel

Exempel 1

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

Anropar URL-https://api.powerbi.com/v1.0/myorg/groups med GET-metoden\verbet.

Parametrar

-Body

Brödtexten i begäran, även kallat innehåll. Detta är valfritt om inte begärandemetoden är POST, PUT eller PATCH.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ContentType

Innehållstyp som ska anges i rubriken för begäran. Standardvärdet är "application/json".

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Headers

Valfria rubriker som ska inkluderas i begäran.

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Method

Typ av HTTP-begärandemetod\verb som ska utföras med anropet.

Typ:	PowerBIWebRequestMethod
Godkända värden:	Get, Post, Delete, Put, Patch, Options
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Organization

Organisationsnamn eller klientorganisations-GUID som ska inkluderas i URL:en. Standardvärdet är "myorg".

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OutFile

Utdatafil för att skriva svarsinnehållet till. Den angivna filsökvägen får inte finnas.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-TimeoutSec

Anger hur länge begäran kan vänta innan tidsgränsen uppnås. Ange ett värde i sekunder. Om du anger värdet 0 anges en tidsgräns på obestämd tid.

Typ:	Int32
Position:	Named
Standardvärde:	100
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Url

Relativ eller absolut URL för den Power BI-entitet som du vill komma åt. Om du till exempel vill komma åt https://api.powerbi.com/v1.0/myorg/groupsanger du "grupper" eller skickar in hela URL:en.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Version

Version av API:et som ska inkluderas i URL:en. Standardvärdet är "v1.0". Ignoreras om -Url är en absolut URL.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Utdata

System.Object

Kommentarer

RELATERADE LÄNKAR