Freigeben über

Invoke-PowerBIRestMethod

  • Referenz
Modul:
MicrosoftPowerBIMgmt.Profile

Führt einen REST-Aufruf des Power BI-Diensts mit der angegebenen URL und dem angegebenen Textkörper aus.

Syntax

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

Beschreibung

Ruft eine REST-Anforderung für den Power BI-Dienst mithilfe des Profils auf, mit dem Sie angemeldet sind. Das REST-Verb kann mithilfe des -Method-Parameters angegeben werden. Der -Body-Parameter ist für die Verben POST, PUT und PATCH erforderlich. Bevor Sie diesen Befehl ausführen, stellen Sie sicher, dass Sie sich mit Connect-PowerBIServiceAccount anmelden.

Beispiele

Beispiel 1

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

Ruft die URL https://api.powerbi.com/v1.0/myorg/groups mit der GET-Methode\verb auf.

Parameter

-Body

Textkörper der Anforderung, auch als Inhaltbezeichnet. Dies ist optional, es sei denn, die Anforderungsmethode ist POST, PUT oder PATCH.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ContentType

Inhaltstyp, der innerhalb des Headers für die Anforderung angegeben werden soll. Der Standardwert ist "application/json".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Headers

Optionale Header, die in die Anforderung eingeschlossen werden sollen.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Method

Typ der HTTP-Anforderungsmethode\verb, die mit dem Aufruf ausgeführt werden soll.

Typ:PowerBIWebRequestMethod
Zulässige Werte:Get, Post, Delete, Put, Patch, Options
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Organization

Organisationsname oder Mandanten-GUID, die in die URL eingeschlossen werden sollen. Der Standardwert ist "myorg".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OutFile

Ausgabedatei zum Schreiben des Antwortinhalts in. Der angegebene Dateipfad darf nicht vorhanden sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt an, wie lange die Anforderung ausstehen kann, bevor ein Zeitüberschreitung erfolgt. Geben Sie einen Wert in Sekunden ein. Wenn Sie einen Wert von 0 eingeben, wird ein unbestimmtes Timeout angegeben.

Typ:Int32
Position:Named
Standardwert:100
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Url

Relative oder absolute URL der Power BI-Entität, auf die Sie zugreifen möchten. Wenn Sie beispielsweise auf https://api.powerbi.com/v1.0/myorg/groupszugreifen möchten, geben Sie "Gruppen" an, oder übergeben Sie die gesamte URL.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Version

Version der API, die in die URL eingeschlossen werden soll. Der Standardwert ist "v1.0". Wird ignoriert, wenn -Url eine absolute URL ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object

Hinweise