Invoke-PowerBIRestMethod
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