Invoke-PowerBIRestMethod

  • 參考
模組:
MicrosoftPowerBIMgmt.Profile

使用指定的 URL 和本文，執行對Power BI 服務的 REST 呼叫。

Syntax

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

Description

使用您登入的設定檔，對Power BI 服務叫用 REST 要求。 您可以使用 -Method 參數來指定 REST 動詞。 動詞 POST、PUT 和 PATCH 都需要 -Body 參數。 執行此命令之前，請確定您使用 Connect-PowerBIServiceAccount 登入。

範例

範例 1

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

使用 GET 方法\verb 叫用 URL https://api.powerbi.com/v1.0/myorg/groups 。

參數

-Body

要求的本文，也稱為 內容。 除非要求方法是 POST、PUT 或 PATCH，否則這是選擇性的。

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

-ContentType

要指定要求標頭內的內容類型。 預設值為 'application/json'。

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

-Headers

要與要求一起包含的選擇性標頭。

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

-Method

要搭配呼叫進行的 HTTP 要求方法\verb 類型。

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

要包含在 URL 中的組織名稱或租使用者 GUID。 預設值為 'myorg'。

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

-OutFile

用於寫入回應內容的輸出檔案。 指定的檔案路徑不得存在。

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

-TimeoutSec

指定要求逾時之前可以擱置的時間長度。以秒為單位輸入值。 輸入值為 0 會指定無限期逾時。

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

-Url

您想要存取之 Power BI 實體的相對或絕對 URL。 例如，如果您想要存取 https://api.powerbi.com/v1.0/myorg/groups ，請指定 'groups'，或傳入整個 URL。

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

-Version

要包含在 URL 中的 API 版本。 預設值為 'v1.0'。 如果 -Url 是絕對 URL，則會忽略。

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

輸入

None

輸出

System.Object

備註