Connect-PowerBIServiceAccount
Faça logon no serviço do Power BI.
Syntax
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>]
Description
Faça logon no serviço do Power BI com uma conta de usuário ou entidade de serviço (chave de aplicativo ou certificado). Para contas de usuário, um aplicativo do Azure Active Directory (AAD) First-Party é utilizado para autenticação. Para fazer logon, chame Disconnect-PowerBIServiceAccount.
Exemplos
Exemplo 1
PS C:\> Connect-PowerBIServiceAccount
Faz logon usando a autenticação do usuário na nuvem pública, um prompt será exibido para coletar credenciais.
Exemplo 2
PS C:\> Connect-PowerBIServiceAccount -Environment China
Faz logon usando a autenticação do usuário na nuvem da China, um prompt será exibido para coletar credenciais.
Exemplo 3
PS C:\> Connect-PowerBIServiceAccount -Tenant [TenantId] -ServicePrincipal -Credential (Get-Credential)
Faz logon usando uma entidade de serviço na nuvem pública, um prompt será exibido de Get-Credential para inserir seu nome de usuário (sua ID de cliente do AAD) e a senha (sua chave secreta do aplicativo).
Exemplo 4
PS C:\> Connect-PowerBIServiceAccount -ServicePrincipal -CertificateThumbprint 38DA4BED389A014E69A6E6D8AE56761E85F0DFA4 -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468
Faz logon usando uma entidade de serviço com um certificado instalado na nuvem pública. O certificado deve ser instalado no repositório de certificados CurrentUser ou LocalMachine (LocalMachine requer acesso de administrador) com uma chave privada instalada.
Parâmetros
-ApplicationId
A ID do aplicativo do Azure Active Directory (AAD) (também conhecida como ID do Cliente) a ser usada com uma impressão digital de certificado (-CertificateThumbprint) para autenticar com uma conta de entidade de serviço (-ServicePrincipal).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Impressão digital do certificado de um certificado instalado associado a um aplicativo do AAD (Azure Active Directory). O certificado deve ser instalado nos repositórios de certificados pessoais CurrentUser ou LocalMachine (LocalMachine requer um prompt de administrador para acessar) com uma chave privada instalada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
PSCredential que representa a ID do cliente do aplicativo do Azure Active Directory (AAD) (nome de usuário) e a chave secreta do aplicativo (senha) para autenticar com uma conta de entidade de serviço (-ServicePrincipal).
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomEnvironment
O ambiente personalizado a ser usado para os ambientes retornados da URL de descoberta.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiscoveryUrl
A URL de descoberta da qual obter as informações dos serviços de back-end. O ambiente personalizado também deve ser fornecido.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Environment
Ambiente de nuvem com o qual se conectar. O padrão é Público.
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
Indica usar uma conta de entidade de serviço, em vez de uma conta de usuário.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tenant
Nome do locatário ou ID de locatário que contém a conta da entidade de serviço. Se não for especificado, o locatário 'COMMON' será usado.
Type: | String |
Aliases: | TenantId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile