Compartilhar via

Invoke-PowerBIRestMethod

  • Referência
Módulo:
MicrosoftPowerBIMgmt.Profile

Executa uma chamada REST para o serviço do Power BI, com a URL e o corpo especificados.

Sintaxe

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

Description

Invoca uma solicitação REST no serviço do Power BI usando o perfil com o qual você está conectado. O verbo REST pode ser especificado usando o parâmetro -Method. O parâmetro -Body é necessário para os verbos POST, PUT e PATCH. Antes de executar esse comando, faça logon usando Connect-PowerBIServiceAccount.

Exemplos

Exemplo 1

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

Invoca a URL https://api.powerbi.com/v1.0/myorg/groups com o método GET\verbo.

Parâmetros

-Body

Corpo da solicitação, também conhecido como conteúdo. Isso é opcional, a menos que o método de solicitação seja POST, PUT ou PATCH.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContentType

Tipo de conteúdo a ser especificado dentro do cabeçalho da solicitação. O padrão é "application/json".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Headers

Cabeçalhos opcionais a serem incluídos com a solicitação.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Method

Tipo de método de solicitação HTTP\verbo a ser feita com a chamada.

Tipo:PowerBIWebRequestMethod
Valores aceitos:Get, Post, Delete, Put, Patch, Options
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Organization

Nome da organização ou GUID de locatário a ser incluído na URL. O padrão é 'myorg'.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OutFile

Arquivo de saída para o qual gravar o conteúdo da resposta. O caminho do arquivo especificado não deve existir.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeoutSec

Especifica quanto tempo a solicitação pode ficar pendente antes de atingir o tempo limite. Insira um valor em segundos. Inserir um valor de 0 especifica um tempo limite indefinido.

Tipo:Int32
Cargo:Named
Valor padrão:100
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Url

URL relativa ou absoluta da entidade do Power BI que você deseja acessar. Por exemplo, se você quiser acessar https://api.powerbi.com/v1.0/myorg/groups, especifique "grupos" ou passe toda a URL.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Version

Versão da API a ser incluída na URL. O padrão é 'v1.0'. Ignorado se -Url é uma URL absoluta.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object

Observações