Connect-PowerBIServiceAccount
Inicie sesión en el servicio Power BI.
Syntax
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 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
Inicia sesión con 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
Inicia sesión con 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)
Inicie sesión con una entidad de servicio en la nube pública; se mostrará un mensaje 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 va a usar con una huella digital de certificado (-CertificateThumbprint) para autenticarse con una cuenta de entidad de servicio (-ServicePrincipal).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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).
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomEnvironment
Entorno personalizado que se va a usar para los entornos devueltos desde la dirección URL de detección.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiscoveryUrl
Dirección URL de detección de la que se obtiene la información de los servicios back-end. También se debe proporcionar un entorno personalizado.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Environment
Entorno en la nube con el que conectarse. El valor predeterminado es Public.
Type: | PowerBIEnvironmentType |
Accepted values: | Public, Germany, USGov, China, USGovHigh, USGovMil |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServicePrincipal
Indica que se usa una cuenta de entidad de servicio, en lugar de una cuenta de usuario.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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".
Type: | String |
Aliases: | TenantId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Salidas
Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile