Invoke-PowerBIRestMethod

Módulo:

MicrosoftPowerBIMgmt.Profile

Ejecuta una llamada REST a la servicio Power BI, con la dirección URL y el cuerpo 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 una solicitud REST en el servicio Power BI mediante el perfil con el que ha iniciado sesión. El verbo REST se puede especificar mediante el parámetro -Method. El parámetro -Body es necesario para los verbos POST, PUT y PATCH. Antes de ejecutar este comando, asegúrese de iniciar sesión con Connect-PowerBIServiceAccount.

Ejemplos

Ejemplo 1

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

Invoca la dirección URL https://api.powerbi.com/v1.0/myorg/groups con el método GET\verbo.

Parámetros

-Body

Cuerpo de la solicitud, también conocido como contenido. Esto es opcional a menos que el método de solicitud sea POST, PUT o PATCH.

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

-ContentType

Tipo de contenido que se va a especificar dentro del encabezado de la solicitud. El valor predeterminado es "application/json".

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

-Headers

Encabezados opcionales que se van a incluir con la solicitud.

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

-Method

Tipo de método de solicitud HTTP\verbo que se va a realizar con la llamada.

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

Nombre de la organización o GUID de inquilino que se va a incluir en la dirección URL. El valor predeterminado es "myorg".

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

-OutFile

Archivo de salida en el que se escribe el contenido de la respuesta. La ruta de acceso de archivo especificada no debe existir.

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

-TimeoutSec

Especifica cuánto tiempo puede estar pendiente la solicitud antes de que se agote el tiempo de espera. Escriba un valor en segundos. Al escribir un valor de 0, se especifica un tiempo de espera indefinido.

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

-Url

Dirección URL relativa o absoluta de la entidad de Power BI a la que desea acceder. Por ejemplo, si desea acceder https://api.powerbi.com/v1.0/myorg/groupsa , especifique "grupos" o pase toda la dirección URL.

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

-Version

Versión de la API que se va a incluir en la dirección URL. El valor predeterminado es "v1.0". Se omite si -Url es una dirección URL absoluta.

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

Entradas

None

Salidas

System.Object

Notas

VÍNCULOS RELACIONADOS