다음을 통해 공유

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 요청을 호출합니다. REST 동사는 -Method 매개 변수를 사용하여 지정할 수 있습니다. 동사 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가 아닌 경우 선택 사항입니다.

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 요청 메서드\동사의 형식입니다.

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하려는 경우 '그룹'을 지정하거나 전체 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

참고