Connect-PowerBIServiceAccount

  • Référence
Module:
MicrosoftPowerBIMgmt.Profile

Connectez-vous au service 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

Connectez-vous à service Power BI avec un compte d’utilisateur ou de principal de service (clé d’application ou certificat). Pour les comptes d’utilisateur, une application First-Party Azure Active Directory (AAD) est exploitée pour l’authentification. Pour vous déconnecter, appelez Disconnect-PowerBIServiceAccount.

Exemples

Exemple 1

PS C:\> Connect-PowerBIServiceAccount

Journaux d’activité à l’aide de l’authentification utilisateur sur le cloud public, une invite s’affiche pour collecter les informations d’identification.

Exemple 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Journaux d’activité à l’aide de l’authentification utilisateur sur le cloud chinois, une invite s’affiche pour collecter les informations d’identification.

Exemple 3

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

Les journaux d’activité à l’aide d’un principal de service sur le cloud public s’affichent à partir de Get-Credential pour entrer votre nom d’utilisateur (votre ID client AAD) et votre mot de passe (clé secrète d’application).

Exemple 4

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

Se connecte à l’aide d’un principal de service avec un certificat installé dans le cloud public. Le certificat doit être installé dans le magasin de certificats CurrentUser ou LocalMachine (LocalMachine nécessite un accès administrateur) avec une clé privée installée.

Paramètres

-ApplicationId

ID d’application Azure Active Directory (AAD) (également appelé ID client) à utiliser avec une empreinte numérique de certificat (-CertificateThumbprint) pour s’authentifier auprès d’un compte principal de service (-ServicePrincipal).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

Empreinte de certificat d’un certificat installé associé à une application Azure Active Directory (AAD). Le certificat doit être installé dans les magasins de certificats personnels CurrentUser ou LocalMachine (LocalMachine requiert une invite d’administrateur pour accéder) avec une clé privée installée.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Credential

PSCredential représentant l’ID client d’application Azure Active Directory (AAD) et la clé secrète d’application (mot de passe) pour s’authentifier auprès d’un compte principal de service (-ServicePrincipal).

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CustomEnvironment

Environnement personnalisé à utiliser pour les environnements retournés à partir de l’URL de découverte.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiscoveryUrl

URL de découverte à partir de laquelle obtenir les informations des services principaux. L’environnement personnalisé doit également être fourni.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Environment

Environnement cloud auquel se connecter. La valeur par défaut est publique.

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

Indique d’utiliser un compte principal de service, par opposition à un compte d’utilisateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tenant

Nom du locataire ou ID de locataire contenant le compte principal de service. Si ce n’est pas spécifié, le locataire « COMMON » est utilisé.

Type:String
Aliases:TenantId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Sorties

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Notes