通过

Invoke-PowerBIRestMethod

  • 参考
模块:
MicrosoftPowerBIMgmt.Profile

使用指定的 URL 和正文执行对 Power BI 服务的 REST 调用。

语法

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

说明

使用登录的配置文件针对 Power BI 服务调用 REST 请求。 可以使用 -Method 参数指定 REST 谓词。 谓词 POST、PUT 和 PATCH 需要 -Body 参数。 运行此命令之前，请确保使用 Connect-PowerBIServiceAccount 登录。

示例

示例 1

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

使用 GET 方法\谓词调用 URL https://api.powerbi.com/v1.0/myorg/groups。

参数

-Body

请求正文，也称为 内容。 除非请求方法是 POST、PUT 或 PATCH，否则这是可选的。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContentType

在请求的标头内指定的内容类型。 默认值为“application/json”。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Headers

要包含在请求中的可选标头。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Method

要通过调用进行的 HTTP 请求方法\谓词的类型。

类型:PowerBIWebRequestMethod
接受的值:Get, Post, Delete, Put, Patch, Options
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Organization

要包含在 URL 中的组织名称或租户 GUID。 默认值为“myorg”。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OutFile

用于将响应内容写入到的输出文件。 指定的文件路径不得存在。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TimeoutSec

指定请求在超时之前可以挂起多长时间。以秒为单位输入值。 输入值 0 指定无限期超时。

类型:Int32
Position:Named
默认值:100
必需:False
接受管道输入:False
接受通配符:False

-Url

要访问的 Power BI 实体的相对或绝对 URL。 例如，如果要访问 https://api.powerbi.com/v1.0/myorg/groups，请指定“组”或传入整个 URL。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Version

要包含在 URL 中的 API 版本。 默认值为“v1.0”。 如果 -Url 是绝对 URL，则忽略。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

System.Object

备注