Invoke-PowerBIRestMethod

Módulo:

MicrosoftPowerBIMgmt.Profile

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

Syntax

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.

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

-ContentType

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

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

-Headers

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

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

-Method

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

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

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

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

-OutFile

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

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

-TimeoutSec

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

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Version

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

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

Entradas

None

Saídas

System.Object

Observações

LINKS RELACIONADOS