Invoke-PowerBIRestMethod
지정된 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 요청을 호출합니다. REST 동사는 -Method 매개 변수를 사용하여 지정할 수 있습니다. -Body 매개 변수는 동사 POST, PUT 및 PATCH에 필요합니다. 이 명령을 실행하기 전에 Connect-PowerBIServiceAccount를 사용하여 로그인해야 합니다.
예제
예제 1
PS C:\> Invoke-PowerBIRestMethod -Url 'groups' -Method GetGET 메서드\동사를 사용하여 URL https://api.powerbi.com/v1.0/myorg/groups 호출합니다.
매개 변수
-Body
콘텐츠라고도 하는 요청 본문입니다. 요청 메서드가 POST, PUT 또는 PATCH가 아닌 경우 선택 사항입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ContentType
요청에 대한 헤더 내에서 지정할 콘텐츠 형식입니다. 기본값은 'application/json'입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Headers
요청에 포함할 선택적 헤더입니다.
| 형식: | Hashtable |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Method
호출을 사용하여 만들 HTTP 요청 메서드\동사의 유형입니다.
| 형식: | PowerBIWebRequestMethod |
| 허용되는 값: | Get, Post, Delete, Put, Patch, Options |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Organization
URL에 포함할 조직 이름 또는 테넌트 GUID입니다. 기본값은 'myorg'입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OutFile
응답 콘텐츠를 쓰기 위한 출력 파일입니다. 지정된 파일 경로가 없어야 합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimeoutSec
요청이 시간 초과되기 전에 보류할 수 있는 기간을 지정합니다. 값을 초 단위로 입력합니다. 값 0을 입력하면 무기한 제한 시간이 지정됩니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | 100 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Url
액세스하려는 Power BI 엔터티의 상대 또는 절대 URL입니다. 예를 들어 https://api.powerbi.com/v1.0/myorg/groups액세스하려면 '그룹'을 지정하거나 전체 URL을 전달합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Version
URL에 포함할 API의 버전입니다. 기본값은 'v1.0'입니다. -Url 절대 URL인 경우 무시됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
System.Object