Partilhar via


Invoke-PowerBIRestMethod

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 contra o 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 este comando, certifique-se de que inicia sessão utilizando 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\verb.

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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ContentType

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Headers

Cabeçalhos opcionais para incluir na solicitação.

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Method

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

Tipo:PowerBIWebRequestMethod
Valores aceites:Get, Post, Delete, Put, Patch, Options
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Organization

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OutFile

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

Especifica por 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
Position:Named
Default value:100
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 a URL inteira.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Version

Versão da API a incluir no URL. O padrão é 'v1.0'. Ignorado se -Url for um URL absoluto.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

System.Object

Notas