Compartir a través de

Invoke-PowerBIRestMethod

Módulo:
MicrosoftPowerBIMgmt.Profile Module

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

Sintaxis

Default (Es el valor predeterminado). 

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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ContentType

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Headers

Encabezados opcionales que se van a incluir con la solicitud.

Propiedades del parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Method

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

Propiedades del parámetro

Tipo:PowerBIWebRequestMethod
Valor predeterminado:None
Valores aceptados:Get, Post, Delete, Put, Patch, Options
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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".

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OutFile

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:100
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

System.Object