Connect-PowerBIServiceAccount

  • Referencia
Módulo:
MicrosoftPowerBIMgmt.Profile

Inicie sesión en el servicio Power BI.

Sintaxis

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

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 de 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

Inicie sesión con la autenticación de usuario en la nube pública; se mostrará una solicitud para recopilar credenciales.

Ejemplo 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Inicie sesión con la autenticación de usuario en la nube de China; se mostrará una solicitud para recopilar credenciales.

Ejemplo 3

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

Inicie sesión con una entidad de servicio en la nube pública; se mostrará una solicitud de Get-Credential para escribir el nombre de usuario (el identificador de cliente de AAD) y la contraseña (la clave secreta de la 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 instalarse en el almacén de certificados CurrentUser o LocalMachine (LocalMachine requiere acceso de administrador) con una clave privada instalada.

Parámetros

-ApplicationId

Identificador de aplicación de Azure Active Directory (AAD) (también conocido como id. de cliente) que se usará con una huella digital de certificado (-CertificateThumbprint) para autenticarse con una cuenta de entidad de servicio (-ServicePrincipal).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CertificateThumbprint

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

PSCredential que representa el identificador de cliente de la aplicación (nombre de usuario) de Azure Active Directory (AAD) y la clave secreta de aplicación (contraseña) para autenticarse con una cuenta de entidad de servicio (-ServicePrincipal).

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomEnvironment

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DiscoveryUrl

Dirección URL de detección para obtener la información de los servicios back-end. También se debe proporcionar un entorno personalizado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Environment

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

Tipo:PowerBIEnvironmentType
Valores aceptados:Public, Germany, USGov, China, USGovHigh, USGovMil
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServicePrincipal

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tenant

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

Tipo:String
Alias:TenantId
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Notas