Partager via

Connect-PowerBIServiceAccount

Module:
MicrosoftPowerBIMgmt.Profile Module

Connectez-vous au service Power BI.

Syntaxe

User (Par défaut) 

Connect-PowerBIServiceAccount
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipal 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-ServicePrincipal]
    [-Tenant <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

UserAndCredential 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipalCertificate 

Connect-PowerBIServiceAccount
    -CertificateThumbprint <String>
    -ApplicationId <String>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-ServicePrincipal]
    [-Tenant <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

Description

Connectez-vous au service Power BI à l’aide d’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)

Si vous vous connectez à 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 (votre clé secrète d’application).

Exemple 4

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

Se connecte au cloud public à l’aide d’un principal de service avec un certificat installé. 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 de principal de service (-ServicePrincipal).

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ServicePrincipalCertificate
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ServicePrincipalCertificate
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Credential

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

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ServicePrincipal
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UserAndCredential
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CustomEnvironment

L’environnement personnalisé à utiliser pour les environnements renvoyés à partir de l’URL de découverte.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DiscoveryUrl

L’URL de découverte à partir de laquelle vous pouvez obtenir les informations sur les services backend. Un environnement personnalisé doit également être fourni.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Environment

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

Propriétés du paramètre

Type:PowerBIEnvironmentType
Valeur par défaut:None
Valeurs acceptées:Public, Germany, USGov, China, USGovHigh, USGovMil
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ServicePrincipal

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ServicePrincipal
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ServicePrincipalCertificate
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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é.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Id de locataire

Jeux de paramètres

ServicePrincipal
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ServicePrincipalCertificate
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile