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

说明

使用用户或服务主体帐户 (应用程序密钥或证书) 登录到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) 进行身份验证。

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

表示 Azure Active Directory (AAD) 应用程序客户端 ID 的 PSCredential (用户名) 和应用程序密钥 (密码) ，以便通过服务主体帐户 (-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

包含服务主体帐户的租户名称或租户 ID。 如果未指定，则使用“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

备注

相关链接