Partager via

Connect-PowerBIServiceAccount

  • Référence
Module:
MicrosoftPowerBIMgmt.Profile

Connectez-vous au service Power BI.

Syntaxe

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

Les journaux d’activité utilisant l’authentification utilisateur sur le cloud public s’affichent pour collecter les informations d’identification.

Exemple 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Les journaux d’activité utilisant l’authentification utilisateur sur le cloud de Chine s’affichent pour collecter les informations d’identification.

Exemple 3

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

Se connecte à l’aide d’un principal de service sur le cloud public, une invite s’affiche à 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CertificateThumbprint

Empreinte numérique du 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 nécessite une invite d’administrateur pour accéder) avec une clé privée installée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

PSCredential représentant l’ID client d’application Azure Active Directory (AAD) (nom d’utilisateur) 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CustomEnvironment

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DiscoveryUrl

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Environment

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

Type:PowerBIEnvironmentType
Valeurs acceptées:Public, Germany, USGov, China, USGovHigh, USGovMil
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicePrincipal

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tenant

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

Type:String
Alias:TenantId
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Notes