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 服務（應用程式密鑰或憑證）。 針對用戶帳戶，會利用 Azure Active Directory （AAD） 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 用戶端識別符）和密碼（您的應用程式秘密密鑰）。
範例 4
PS C:\> Connect-PowerBIServiceAccount -ServicePrincipal -CertificateThumbprint 38DA4BED389A014E69A6E6D8AE56761E85F0DFA4 -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468使用服務主體將已安裝的憑證登入公用雲端。 憑證必須安裝在 CurrentUser 或 LocalMachine 證書存儲中（LocalMachine 需要系統管理員存取權），並安裝私鑰。
參數
-ApplicationId
Azure Active Directory （AAD） 應用程式識別碼（也稱為用戶端標識符）用於憑證指紋（-CertificateThumbprint），以向服務主體帳戶進行驗證（-ServicePrincipal）。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CertificateThumbprint
與 Azure Active Directory （AAD） 應用程式相關聯的已安裝憑證憑證指紋。 憑證必須安裝在已安裝私鑰的 CurrentUser 或 LocalMachine 個人證書存儲中（LocalMachine 需要系統管理員提示才能存取）。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
PSCredential 代表 Azure Active Directory （AAD） 應用程式用戶端識別碼（使用者名稱）和應用程式秘密密鑰（密碼）來向服務主體帳戶進行驗證（-ServicePrincipal）。
| 類型: | PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CustomEnvironment
要用於從探索 URL 傳回之環境的自定義環境。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DiscoveryUrl
要從中取得後端服務資訊的探索URL。 也必須提供自定義環境。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Environment
要連線的雲端環境。 預設值為 Public。
| 類型: | PowerBIEnvironmentType |
| 接受的值: | Public, Germany, USGov, China, USGovHigh, USGovMil |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ServicePrincipal
表示使用服務主體帳戶，而不是用戶帳戶。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Tenant
包含服務主體帳戶的租用戶名稱或租使用者標識碼。 如果未指定，則會使用 『COMMON』 租使用者。
| 類型: | String |
| 別名: | TenantId |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile