Connect-PowerBIServiceAccount
Power BI 서비스에 로그인합니다.
구문
Connect-PowerBIServiceAccount
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <String>]
[-DiscoveryUrl <String>]
[<CommonParameters>] Connect-PowerBIServiceAccount
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <String>]
-Credential <PSCredential>
[-ServicePrincipal]
[-Tenant <String>]
[-DiscoveryUrl <String>]
[<CommonParameters>] Connect-PowerBIServiceAccount
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <String>]
-Credential <PSCredential>
[-DiscoveryUrl <String>]
[<CommonParameters>] Connect-PowerBIServiceAccount
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <String>]
-CertificateThumbprint <String>
-ApplicationId <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 |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CertificateThumbprint
AAD(Azure Active Directory) 애플리케이션에 연결된 설치된 인증서의 인증서 지문입니다. 프라이빗 키가 설치된 CurrentUser 또는 LocalMachine 개인 인증서 저장소(LocalMachine에 액세스하려면 관리자 프롬프트 필요)에 인증서를 설치해야 합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Credential
서비스 주체 계정(-ServicePrincipal)으로 인증하기 위해 AAD(Azure Active Directory) 애플리케이션 클라이언트 ID(사용자 이름) 및 애플리케이션 비밀 키(암호)를 나타내는 PSCredential입니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CustomEnvironment
검색 URL에서 반환된 환경에 사용할 사용자 지정 환경입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DiscoveryUrl
백 엔드 서비스 정보를 가져올 검색 URL입니다. 사용자 지정 환경도 제공해야 합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Environment
연결할 클라우드 환경입니다. 기본값은 Public입니다.
| 형식: | PowerBIEnvironmentType |
| 허용되는 값: | Public, Germany, USGov, China, USGovHigh, USGovMil |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ServicePrincipal
사용자 계정이 아닌 서비스 주체 계정을 사용하도록 나타냅니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Tenant
서비스 주체 계정을 포함하는 테넌트 이름 또는 테넌트 ID입니다. 지정하지 않으면 'COMMON' 테넌트가 사용됩니다.
| 형식: | String |
| 별칭: | TenantId |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile