Partilhar via

Connect-PowerBIServiceAccount

Módulo:
MicrosoftPowerBIMgmt.Profile Module

Inicie sessão no serviço do Power BI.

Sintaxe

User (Predefinição) 

Connect-PowerBIServiceAccount
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipal 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-ServicePrincipal]
    [-Tenant <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

UserAndCredential 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipalCertificate 

Connect-PowerBIServiceAccount
    -CertificateThumbprint <String>
    -ApplicationId <String>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <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).

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ServicePrincipalCertificate
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ServicePrincipalCertificate
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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).

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ServicePrincipal
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
UserAndCredential
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CustomEnvironment

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Environment

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

Propriedades dos parâmetros

Tipo:PowerBIEnvironmentType
Default value:None
Valores aceites:Public, Germany, USGov, China, USGovHigh, USGovMil
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ServicePrincipal

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ServicePrincipal
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ServicePrincipalCertificate
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Id de Inquilino

Conjuntos de parâmetros

ServicePrincipal
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ServicePrincipalCertificate
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile