Invoke-PowerBIRestMethod

Módulo:

MicrosoftPowerBIMgmt.Profile

Executa uma chamada REST para o serviço Power BI, com o 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 um pedido de REPOUSO contra o serviço Power BI usando o perfil com o qual está a iniciar sessão. O verbo REST pode ser especificado usando o parâmetro -Método. O parâmetro -Corpo é necessário para os verbos POST, PUT e PATCH. Antes de executar este comando, certifique-se de que inicia sessão utilizando o Connect-PowerBIServiceAccount.

Exemplos

Exemplo 1

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

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

Parâmetros

-Body

Corpo do pedido, também conhecido como conteúdo. Isto é opcional a menos que o método de pedido 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 para especificar dentro do cabeçalho para o pedido. 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 para incluir com o pedido.

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

-Method

Tipo de método de pedido HTTP\verbo para fazer 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 inquilino GUID para incluir na URL. O padrão é "myorg".

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

-OutFile

Ficheiro de saída para escrever o conteúdo de resposta a. O caminho do ficheiro 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 o pedido pode estar pendente antes do tempo de funcionação. Introduza um valor em segundos. Introduzir um valor de 0 especifica um tempo de tempo indefinido.

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Url

URL relativo ou absoluto da entidade Power BI a que pretende aceder. Por exemplo, se quiser aceder https://api.powerbi.com/v1.0/myorg/groups, especifique 'grupos', ou passe em 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 para incluir no 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

Notas

LIGAÇÕES RELACIONADAS