Connect-PowerBIServiceAccount

Módulo:

MicrosoftPowerBIMgmt.Profile

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

Observações

LINKS RELACIONADOS