Invoke-PowerBIRestMethod

Módulo:

MicrosoftPowerBIMgmt.Profile

Ejecuta una llamada REST al servicio Power BI, con la dirección URL y el cuerpo especificados.

Sintaxis

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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ContentType

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Headers

Encabezados opcionales que se van a incluir con la solicitud.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Method

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

Tipo:	PowerBIWebRequestMethod
Valores aceptados:	Get, Post, Delete, Put, Patch, Options
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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".

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OutFile

Archivo de salida para escribir el contenido de la respuesta en. La ruta de acceso del archivo especificada no debe existir.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	100
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Url

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

System.Object

Notas

VÍNCULOS RELACIONADOS