Compartilhar via

Connect-PowerBIServiceAccount

  • Referência
Módulo:
MicrosoftPowerBIMgmt.Profile

Faça logon no serviço do Power BI.

Sintaxe

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 AAD (Azure Active Directory) First-Party é aproveitado para autenticação. Para fazer logoff, 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 de 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

ID do aplicativo AAD (Azure Active Directory) (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).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

PSCredential que representa a ID do cliente de aplicativo do Azure Active Directory (nome de usuário) e a chave secreta do aplicativo (senha) para autenticar com uma conta de entidade de serviço (-ServicePrincipal).

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomEnvironment

O ambiente personalizado a ser usado para os ambientes retornados da URL de descoberta.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Environment

Ambiente de nuvem com o qual se conectar. O padrão é Público.

Tipo:PowerBIEnvironmentType
Valores aceitos:Public, Germany, USGov, China, USGovHigh, USGovMil
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServicePrincipal

Indica usar uma conta de entidade de serviço, em vez de uma conta de usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tenant

Nome do locatário ou ID do locatário que contém a conta da entidade de serviço. Se não for especificado, o locatário 'COMMON' será usado.

Tipo:String
Aliases:TenantId
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Observações