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) 进行身份验证。
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