Compartir a través de

Connect-PowerBIServiceAccount

Módulo:
MicrosoftPowerBIMgmt.Profile Module

Inicie sesión en el servicio Power BI.

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

Inicie sesión en el servicio Power BI con una cuenta de usuario o entidad de servicio (clave de aplicación o certificado). En el caso de las cuentas de usuario, se aprovecha una aplicación First-Party de Azure Active Directory (AAD) para la autenticación. Para cerrar la sesión, llame a Disconnect-PowerBIServiceAccount.

Ejemplos

Ejemplo 1

PS C:\> Connect-PowerBIServiceAccount

Al iniciar sesión mediante la autenticación de usuario en la nube pública, se mostrará un mensaje para recopilar credenciales.

Ejemplo 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Al iniciar sesión mediante la autenticación de usuario en la nube de China, se mostrará un mensaje para recopilar credenciales.

Ejemplo 3

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

Al iniciar sesión con una entidad de servicio en la nube pública, se mostrará un mensaje de Get-Credential para escribir su nombre de usuario (su ID de cliente de AAD) y contraseña (su clave secreta de aplicación).

Ejemplo 4

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

Inicia sesión con una entidad de servicio con un certificado instalado en la nube pública. El certificado debe estar instalado en el almacén de certificados CurrentUser o LocalMachine (LocalMachine requiere acceso de administrador) con una clave privada instalada.

Parámetros

-ApplicationId

Id. de aplicación de Azure Active Directory (AAD) (también conocido como identificador de cliente) que se usará con una huella digital de certificado (-CertificateThumbprint) para autenticarse con una cuenta de entidad de servicio (-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

Huella digital de un certificado instalado asociado a una aplicación de Azure Active Directory (AAD). El certificado debe estar instalado en los almacenes de certificados personales CurrentUser o LocalMachine (LocalMachine requiere un mensaje de administrador para acceder) con una clave privada instalada.

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 que representa el identificador de cliente de la aplicación (nombre de usuario) y la clave secreta de la aplicación (contraseña) de Azure Active Directory (AAD) para autenticarse con una cuenta de entidad de servicio (-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

El entorno personalizado que se va a usar para los entornos devueltos desde la dirección URL de detección.

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

La dirección URL de detección de la que se obtendrá la información de los servicios de back-end. También se debe proporcionar un entorno personalizado.

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

Entorno en la nube con el que conectarse. El valor predeterminado es Público.

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

Indica que se debe usar una cuenta de entidad de servicio, en lugar de una cuenta de usuario.

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

Nombre de inquilino o identificador de inquilino que contiene la cuenta de entidad de servicio. Si no se especifica, se utiliza el inquilino 'COMMON'.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Id del inquilino

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile