Connect-PowerBIServiceAccount

  • 參考
模組:
MicrosoftPowerBIMgmt.Profile

登入Power BI 服務。

Syntax

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) 進行驗證。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

與 Azure Active Directory (AAD) 應用程式相關聯的已安裝憑證憑證指紋。 憑證必須安裝在 CurrentUser 或 LocalMachine 個人憑證存儲中， (LocalMachine 需要系統管理員提示，才能使用已安裝私密金鑰來存取) 。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Credential

PSCredential 代表 Azure Active Directory (AAD) 應用程式用戶端識別碼 (使用者名稱) 和應用程式秘密金鑰 (密碼) 向服務主體帳戶 (-ServicePrincipal) 進行驗證。

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CustomEnvironment

要用於從探索 URL 傳回之環境的自訂環境。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiscoveryUrl

要從中取得後端服務資訊的探索 URL。 也必須提供自訂環境。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Environment

要連線的雲端環境。 預設值為 Public。

Type:PowerBIEnvironmentType
Accepted values:Public, Germany, USGov, China, USGovHigh, USGovMil
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipal

表示使用服務主體帳戶，而不是使用者帳戶。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tenant

包含服務主體帳戶的租使用者名稱或租使用者識別碼。 如果未指定，則會使用 'COMMON' 租使用者。

Type:String
Aliases:TenantId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

輸出

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

備註