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