다음을 통해 공유

Connect-PowerBIServiceAccount

모듈:
MicrosoftPowerBIMgmt.Profile Module

Power BI 서비스에 로그인합니다.

구문

User (기본값) 

Connect-PowerBIServiceAccount
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipal 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-ServicePrincipal]
    [-Tenant <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

UserAndCredential 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipalCertificate 

Connect-PowerBIServiceAccount
    -CertificateThumbprint <String>
    -ApplicationId <String>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-ServicePrincipal]
    [-Tenant <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

Description

사용자 또는 서비스 주체 계정(애플리케이션 키 또는 인증서)을 사용하여 Power BI 서비스에 로그인합니다. 사용자 계정의 경우 AAD(Azure Active Directory) First-Party 애플리케이션을 인증에 활용합니다. 로그아웃하려면 Disconnect-PowerBIServiceAccount를 호출합니다.

예제

예제 1

PS C:\> Connect-PowerBIServiceAccount

퍼블릭 클라우드에 대한 사용자 인증을 사용하여 로그인하면 자격 증명을 수집하라는 메시지가 표시됩니다.

예제 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

중국 클라우드에 대한 사용자 인증을 사용하여 로그인하면 자격 증명을 수집하라는 메시지가 표시됩니다.

예제 3

PS C:\> Connect-PowerBIServiceAccount -Tenant [TenantId] -ServicePrincipal -Credential (Get-Credential)

퍼블릭 클라우드에 대해 서비스 주체를 사용하여 로그인하면 Get-Credential 사용자 이름(AAD 클라이언트 ID) 및 암호(애플리케이션 비밀 키)를 입력하라는 메시지가 표시됩니다.

예제 4

PS C:\> Connect-PowerBIServiceAccount -ServicePrincipal -CertificateThumbprint 38DA4BED389A014E69A6E6D8AE56761E85F0DFA4 -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468

퍼블릭 클라우드에 설치된 인증서와 함께 서비스 주체를 사용하여 로그인합니다. 프라이빗 키가 설치된 CurrentUser 또는 LocalMachine 인증서 저장소(LocalMachine에는 관리자 액세스 필요)에 인증서를 설치해야 합니다.

매개 변수

-ApplicationId

AAD(Azure Active Directory) 애플리케이션 ID(클라이언트 ID라고도 함)는 인증서 지문(-CertificateThumbprint)과 함께 사용하여 서비스 주체 계정(-ServicePrincipal)으로 인증합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ServicePrincipalCertificate
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-CertificateThumbprint

AAD(Azure Active Directory) 애플리케이션에 연결된 설치된 인증서의 인증서 지문입니다. 프라이빗 키가 설치된 CurrentUser 또는 LocalMachine 개인 인증서 저장소(LocalMachine에 액세스하려면 관리자 프롬프트 필요)에 인증서를 설치해야 합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ServicePrincipalCertificate
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Credential

서비스 주체 계정(-ServicePrincipal)으로 인증하기 위해 AAD(Azure Active Directory) 애플리케이션 클라이언트 ID(사용자 이름) 및 애플리케이션 비밀 키(암호)를 나타내는 PSCredential입니다.

매개 변수 속성

형식:PSCredential
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ServicePrincipal
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
UserAndCredential
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-CustomEnvironment

검색 URL에서 반환된 환경에 사용할 사용자 지정 환경입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DiscoveryUrl

백 엔드 서비스 정보를 가져올 검색 URL입니다. 사용자 지정 환경도 제공해야 합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Environment

연결할 클라우드 환경입니다. 기본값은 Public입니다.

매개 변수 속성

형식:PowerBIEnvironmentType
Default value:None
허용되는 값:Public, Germany, USGov, China, USGovHigh, USGovMil
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ServicePrincipal

사용자 계정이 아닌 서비스 주체 계정을 사용하도록 나타냅니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ServicePrincipal
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ServicePrincipalCertificate
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Tenant

서비스 주체 계정을 포함하는 테넌트 이름 또는 테넌트 ID입니다. 지정하지 않으면 'COMMON' 테넌트가 사용됩니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:테넌트아이디

매개 변수 집합

ServicePrincipal
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ServicePrincipalCertificate
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

출력

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile