共用方式為

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>]

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，否則這是選擇性的。

類型: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 要求方法\verb 的型別，以呼叫進行。

類型: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，請指定 '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

備註