Invoke-PowerBIRestMethod

Modul:

MicrosoftPowerBIMgmt.Profile

Menjalankan panggilan REST ke layanan Power BI, dengan URL dan isi yang ditentukan.

Sintaks

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

Deskripsi

Memanggil permintaan REST terhadap layanan Power BI menggunakan profil yang Anda gunakan untuk masuk. Kata kerja REST dapat ditentukan menggunakan parameter -Method. Parameter -Body diperlukan untuk kata kerja POST, PUT, dan PATCH. Sebelum Anda menjalankan perintah ini, pastikan Anda masuk menggunakan Connect-PowerBIServiceAccount.

Contoh

Contoh 1

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

Memanggil URL https://api.powerbi.com/v1.0/myorg/groups dengan metode GET\verb.

Parameter

-Body

Isi permintaan, juga dikenal sebagai konten. Ini opsional kecuali metode permintaan adalah POST, PUT, atau PATCH.

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

-ContentType

Jenis konten yang akan ditentukan di dalam header untuk permintaan. Defaultnya adalah 'application/json'.

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

-Headers

Header opsional untuk disertakan dengan permintaan.

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

-Method

Jenis metode permintaan HTTP\kata kerja yang akan dilakukan dengan panggilan.

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

Nama organisasi atau GUID penyewa untuk disertakan dalam URL. Defaultnya adalah 'myorg'.

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

-OutFile

File output untuk menulis konten respons. Jalur file yang ditentukan tidak boleh ada.

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

-TimeoutSec

Menentukan berapa lama permintaan dapat tertunda sebelum waktu habis. Masukkan nilai dalam detik. Memasukkan nilai 0 menentukan waktu habis yang tidak terbatas.

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

-Url

URL relatif atau absolut entitas Power BI yang ingin Anda akses. Misalnya, jika Anda ingin mengakses https://api.powerbi.com/v1.0/myorg/groups, tentukan 'grup', atau teruskan di seluruh URL.

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

-Version

Versi API untuk disertakan dalam URL. Defaultnya adalah 'v1.0'. Diabaikan jika -Url adalah URL absolut.

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

Input

None

Output

System.Object

Catatan

Tautan terkait