Поделиться через

Invoke-PowerBIRestMethod

  • Ссылка
Модуль:
MicrosoftPowerBIMgmt.Profile

Выполняет вызов REST к службе Power BI с указанным URL-адресом и текстом.

Синтаксис

Invoke-PowerBIRestMethod
      -Url <String>
      -Method <PowerBIWebRequestMethod>
      [-Body <String>]
      [-OutFile <String>]
      [-ContentType <String>]
      [-Headers <Hashtable>]
      [-TimeoutSec <Int32>]
      [-Organization <String>]
      [-Version <String>]
      [<CommonParameters>]

Описание

Вызывает запрос REST к службе Power BI, используя профиль, с помощью вошедшего в систему профиля. Команду REST можно указать с помощью параметра -Method. Параметр -Body необходим для команд POST, PUT и PATCH. Перед выполнением этой команды обязательно выполните вход с помощью Connect-PowerBIServiceAccount.

Примеры

Пример 1

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

Вызывает URL-адрес https://api.powerbi.com/v1.0/myorg/groups с помощью метода GET\verb.

Параметры

-Body

Текст запроса, также известный как содержимое. Это необязательно, если метод запроса не является POST, PUT или PATCH.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ContentType

Тип контента для указания внутри заголовка запроса. Значение по умолчанию — application/json.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Headers

Необязательные заголовки для включения в запрос.

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Method

Тип метода HTTP-запроса\verb для выполнения вызова.

Тип:PowerBIWebRequestMethod
Допустимые значения:Get, Post, Delete, Put, Patch, Options
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Organization

Имя организации или GUID клиента для включения в URL-адрес. По умолчанию используется myorg.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OutFile

Выходной файл для записи содержимого ответа в. Указанный путь к файлу не должен существовать.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TimeoutSec

Указывает время ожидания запроса до истечения времени ожидания. Введите значение в секундах. При вводе значения 0 указывается неопределенное время ожидания.

Тип:Int32
Position:Named
Default value:100
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Url

Относительный или абсолютный URL-адрес сущности Power BI, к которой требуется получить доступ. Например, если вы хотите получить доступ к https://api.powerbi.com/v1.0/myorg/groups, укажите "группы" или передайте весь URL-адрес.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Version

Версия API для включения в URL-адрес. Значение по умолчанию — v1.0. Игнорируется, если -Url является абсолютным URL-адресом.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

System.Object

Примечания