Connect-PowerBIServiceAccount

參考

模組:: MicrosoftPowerBIMgmt.Profile

登錄到 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 用戶端 ID）和密碼（應用程式密鑰）。

範例 4

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

使用安裝了證書的服務主體登錄到公有雲。證書必須安裝在 CurrentUser 或 LocalMachine 證書存儲中（LocalMachine 需要管理員訪問許可權），並安裝了私鑰。

參數

-ApplicationId

Azure Active Directory （AAD）應用程式 ID（也稱為用戶端 ID），用於證書指紋（-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）應用程式用戶端 ID （使用者名）和應用程式金鑰（密碼），以使用服務主體帳戶（-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

包含服務主體帳戶的租戶名稱或租戶ID。如果未指定，則使用『COMMON』租戶。

類型:	String
別名:	TenantId
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False