Connect-PowerBIServiceAccount

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

VÍNCULOS RELACIONADOS