Connect-PowerBIServiceAccount
语法
User （默认值）
Connect-PowerBIServiceAccount
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <String>]
[-DiscoveryUrl <String>]
[<CommonParameters>]
ServicePrincipal
Connect-PowerBIServiceAccount
-Credential <PSCredential>
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <String>]
[-ServicePrincipal]
[-Tenant <String>]
[-DiscoveryUrl <String>]
[<CommonParameters>]
UserAndCredential
Connect-PowerBIServiceAccount
-Credential <PSCredential>
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <String>]
[-DiscoveryUrl <String>]
[<CommonParameters>]
ServicePrincipalCertificate
Connect-PowerBIServiceAccount
-CertificateThumbprint <String>
-ApplicationId <String>
[-Environment <PowerBIEnvironmentType>]
[-CustomEnvironment <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
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ServicePrincipalCertificate
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CertificateThumbprint
与 Azure Active Directory （AAD） 应用程序关联的已安装证书的证书指纹。
证书必须安装在 CurrentUser 或 LocalMachine 个人证书存储（LocalMachine 需要管理员提示才能访问）中，并安装私钥。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ServicePrincipalCertificate
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Credential
PSCredential 表示 Azure Active Directory （AAD） 应用程序客户端 ID （用户名） 和应用程序密钥 （密码），以使用服务主体帐户 （-ServicePrincipal） 进行身份验证。
参数属性
| 类型: | PSCredential
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ServicePrincipal
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
UserAndCredential
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CustomEnvironment
用于从发现 URL 返回的环境的自定义环境。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DiscoveryUrl
要从中获取后端服务信息的发现 URL。 还必须提供自定义环境。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Environment
要连接的云环境。 默认值为 Public。
参数属性
| 类型: | PowerBIEnvironmentType
|
| 默认值: | None |
| 接受的值: | Public, Germany, USGov, China, USGovHigh, USGovMil |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ServicePrincipal
指示使用服务主体账户，而不是用户账户。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ServicePrincipal
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
ServicePrincipalCertificate
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Tenant
包含服务主体帐户的租户名称或租户 ID。 如果未指定，则使用 'COMMON' 租户。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 租户ID |
参数集
ServicePrincipal
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
ServicePrincipalCertificate
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
None
输出
Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile