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