Compartir a través de

Connect-PowerBIServiceAccount

Módulo:
MicrosoftPowerBIMgmt.Profile Module

Log in to the Power BI service.

Sintaxis

User (Es el valor predeterminado). 

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

Log in to Power BI service with either a user or service principal account (application key or certificate). For user accounts, an Azure Active Directory (AAD) First-Party application is leveraged for authentication. To log out call Disconnect-PowerBIServiceAccount.

Ejemplos

Example 1

PS C:\> Connect-PowerBIServiceAccount

Logs in using user authentication against the Public cloud, a prompt will display to collect credentials.

Example 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Logs in using user authentication against the China cloud, a prompt will display to collect credentials.

Example 3

PS C:\> Connect-PowerBIServiceAccount -Tenant [TenantId] -ServicePrincipal -Credential (Get-Credential)

Logs in using a service principal against the Public cloud, a prompt will display from Get-Credential to enter your username (your AAD client ID) and password (your application secret key).

Example 4

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

Logs in using a service principal with an installed certificate to the Public cloud. The certificate must be installed in either CurrentUser or LocalMachine certificate store (LocalMachine requires administrator access) with a private key installed.

Parámetros

-ApplicationId

Azure Active Directory (AAD) application ID (also known as Client ID) to be used with a certificate thumbprint (-CertificateThumbprint) to authenticate with a service principal account (-ServicePrincipal).

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ServicePrincipalCertificate
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificateThumbprint

Certificate thumbprint of an installed certificate associated to an Azure Active Directory (AAD) application. Certificate must be installed in either the CurrentUser or LocalMachine personal certificate stores (LocalMachine requires an administrator prompt to access) with a private key installed.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ServicePrincipalCertificate
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Credential

PSCredential representing the Azure Active Directory (AAD) application client ID (username) and application secret key (password) to authenticate with a service principal account (-ServicePrincipal).

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ServicePrincipal
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
UserAndCredential
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CustomEnvironment

The custom environment to use for the environments returned from the discovery url.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DiscoveryUrl

The discovery url to get the backend services info from. Custom environment must also be supplied.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Environment

Cloud environment to connect against. Default is Public.

Propiedades del parámetro

Tipo:PowerBIEnvironmentType
Valor predeterminado:None
Valores aceptados:Public, Germany, USGov, China, USGovHigh, USGovMil
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServicePrincipal

Indicates to use a service principal account, as opposed to a user account.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ServicePrincipal
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ServicePrincipalCertificate
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Tenant

Tenant name or tenant ID containing the service principal account. If not specified, the 'COMMON' tenant is used.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:TenantId

Conjuntos de parámetros

ServicePrincipal
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ServicePrincipalCertificate
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Entradas

None

Salidas

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile