Freigeben über

Invoke-PowerBIRestMethod

Modul:
MicrosoftPowerBIMgmt.Profile Module

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

Syntax

Default (Standardwert) 

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 Inhalt bezeichnet. Dies ist optional, es sei denn, die Anforderungsmethode ist POST, PUT oder PATCH.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ContentType

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Headers

Optionale Header, die in die Anforderung eingeschlossen werden sollen.

Parametereigenschaften

Typ:Hashtable
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Method

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

Parametereigenschaften

Typ:PowerBIWebRequestMethod
Standardwert:None
Zulässige Werte:Get, Post, Delete, Put, Patch, Options
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Organization

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OutFile

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TimeoutSec

Gibt an, wie lange die Anforderung ausstehen kann, bevor es zu einer Zeitüberschreitung kommt. Bitte geben Sie einen Wert in Sekunden ein. Wenn Sie einen Wert von 0 eingeben, wird ein unbestimmtes Timeout angegeben.

Parametereigenschaften

Typ:Int32
Standardwert:100
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.Object