Connect-PowerBIServiceAccount

Módulo:

MicrosoftPowerBIMgmt.Profile

Inicie sessão 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 um usuário ou uma conta principal de serviço (chave de aplicativo ou certificado). Para contas de usuário, um aplicativo First-Party do Azure Ative Directory (AAD) é aproveitado para autenticação. Para fazer logout, chame Disconnect-PowerBIServiceAccount.

Exemplos

Exemplo 1

PS C:\> Connect-PowerBIServiceAccount

Efetua login 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

Efetua login 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)

Efetua login usando uma entidade de serviço na nuvem pública, um prompt será exibido a partir de Get-Credential para inserir seu nome de usuário (seu ID de cliente AAD) e senha (sua chave secreta do aplicativo).

Exemplo 4

PS C:\> Connect-PowerBIServiceAccount -ServicePrincipal -CertificateThumbprint 38DA4BED389A014E69A6E6D8AE56761E85F0DFA4 -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468

Efetua login usando uma entidade de serviço com um certificado instalado na nuvem pública. O certificado deve ser instalado no armazenamento de certificados CurrentUser ou LocalMachine (LocalMachine requer acesso de administrador) com uma chave privada instalada.

Parâmetros

-ApplicationId

ID do aplicativo do Azure Ative 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 principal de serviço (-ServicePrincipal).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CertificateThumbprint

Impressão digital do certificado de um certificado instalado associado a um aplicativo do Azure Ative Directory (AAD). O certificado deve ser instalado nos armazenamentos de certificados pessoais CurrentUser ou LocalMachine (LocalMachine requer um prompt de administrador para acessar) com uma chave privada instalada.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Credential

PSCredential representando a ID do cliente do aplicativo do Azure Ative Directory (AAD) (nome de usuário) e a chave secreta do aplicativo (senha) para autenticar com uma conta principal de serviço (-ServicePrincipal).

Tipo:	PSCredential
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CustomEnvironment

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DiscoveryUrl

A url de descoberta a partir da qual obter as informações dos serviços de back-end. O ambiente personalizado também deve ser fornecido.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Environment

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

Tipo:	PowerBIEnvironmentType
Valores aceites:	Public, Germany, USGov, China, USGovHigh, USGovMil
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ServicePrincipal

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Tenant

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

Tipo:	String
Aliases:	TenantId
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Notas

LINKS RELACIONADOS