Invoke-PowerBIRestMethod

  • Référence
Module:
MicrosoftPowerBIMgmt.Profile

Exécute un appel REST au service Power BI, avec l’URL et le corps spécifiés.

Syntaxe

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

Description

Appelle une requête REST sur le service Power BI à l’aide du profil avec lequel vous êtes connecté. Le verbe REST peut être spécifié à l’aide du paramètre -Method. Le paramètre -Body est requis pour les verbes POST, PUT et PATCH. Avant d’exécuter cette commande, veillez à vous connecter à l’aide de Connect-PowerBIServiceAccount.

Exemples

Exemple 1

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

Appelle l’URL https://api.powerbi.com/v1.0/myorg/groups avec la méthode GET\verb.

Paramètres

-Body

Corps de la requête, également appelé contenu. Cela est facultatif, sauf si la méthode de requête est POST, PUT ou PATCH.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContentType

Type de contenu à spécifier à l’intérieur de l’en-tête de la demande. La valeur par défaut est « application/json ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Headers

En-têtes facultatifs à inclure avec la requête.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Method

Type de méthode de requête HTTP\verbe à effectuer avec l’appel.

Type:PowerBIWebRequestMethod
Valeurs acceptées:Get, Post, Delete, Put, Patch, Options
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Organization

Nom de l’organisation ou GUID de locataire à inclure dans l’URL. La valeur par défaut est « myorg ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OutFile

Fichier de sortie dans lequel écrire le contenu de la réponse. Le chemin d’accès spécifié ne doit pas exister.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie la durée pendant laquelle la requête peut être en attente avant qu’elle expire. Entrez une valeur en secondes. La saisie d’une valeur de 0 spécifie un délai d’attente indéfini.

Type:Int32
Position:Named
Valeur par défaut:100
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Url

URL relative ou absolue de l’entité Power BI à accéder. Par exemple, si vous souhaitez accéder à https://api.powerbi.com/v1.0/myorg/groups, spécifiez « groupes » ou transmettez l’URL entière.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Version

Version de l’API à inclure dans l’URL. La valeur par défaut est « v1.0 ». Ignoré si -Url est une URL absolue.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object

Notes