Invoke-PowerBIRestMethod

  • Referenz
Modul:
MicrosoftPowerBIMgmt.Profile

Führt einen REST-Aufruf des Power BI-Dienst 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 die Power BI-Dienst mithilfe des Profils auf, mit dem Sie angemeldet sind. Das REST-Verb kann mithilfe des Parameters "-Method" angegeben werden. Der Parameter "-Body" 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 Inhalt bezeichnet. Dies ist optional, es sei denn, die Anforderungsmethode ist POST, PUT oder PATCH.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Headers

Optionale Header, die in die Anforderung einbezogen werden sollen.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Method

Typ der HTTP-Anforderungsmethode\verb, die mit dem Aufruf vorgenommen werden soll.

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutFile

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

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

Type:Int32
Position:Named
Default value:100
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Url

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Version

Version der API, die in die URL aufgenommen werden soll. Der Standardwert ist "v1.0". Ignoriert, wenn -URL eine absolute URL ist.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

System.Object

Hinweise