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>]

说明

使用用户或服务主体帐户(应用程序密钥或证书)登录到 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 表示使用服务主体帐户(-ServicePrincipal)进行身份验证的 Azure Active Directory(AAD)应用程序客户端 ID(用户名)和应用程序密钥(密码)。

类型: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

输入

None

输出

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

备注