Condividi tramite

Connect-PowerBIServiceAccount

  • Riferimento
Modulo:
MicrosoftPowerBIMgmt.Profile

Accedere al servizio Power BI.

Sintassi

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

Descrizione

Accedere al servizio Power BI con un account utente o un'entità servizio (chiave applicazione o certificato). Per gli account utente, un'applicazione di First-Party di Azure Active Directory (AAD) viene sfruttata per l'autenticazione. Per disconnettersi, chiamare Disconnect-PowerBIServiceAccount.

Esempio

Esempio 1

PS C:\> Connect-PowerBIServiceAccount

Esegue l'accesso usando l'autenticazione utente nel cloud pubblico. Verrà visualizzato un prompt per raccogliere le credenziali.

Esempio 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Esegue l'accesso usando l'autenticazione utente nel cloud cina, viene visualizzato un prompt per raccogliere le credenziali.

Esempio 3

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

Esegue l'accesso usando un'entità servizio nel cloud pubblico, viene visualizzata una richiesta da Get-Credential per immettere il nome utente (ID client AAD) e la password (chiave privata dell'applicazione).

Esempio 4

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

Esegue l'accesso usando un'entità servizio con un certificato installato nel cloud pubblico. Il certificato deve essere installato nell'archivio certificati CurrentUser o LocalMachine (LocalMachine richiede l'accesso amministratore) con una chiave privata installata.

Parametri

-ApplicationId

ID applicazione di Azure Active Directory (AAD) (noto anche come ID client) da usare con un'identificazione personale del certificato (-CertificateThumbprint) per eseguire l'autenticazione con un account dell'entità servizio (-ServicePrincipal).

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificateThumbprint

Identificazione personale del certificato di un certificato installato associato a un'applicazione Azure Active Directory (AAD). Il certificato deve essere installato negli archivi certificati personali CurrentUser o LocalMachine (LocalMachine richiede un prompt di amministratore per l'accesso) con una chiave privata installata.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

PSCredential che rappresenta l'ID client dell'applicazione Azure Active Directory (AAD) (nome utente) e la chiave privata dell'applicazione (password) per l'autenticazione con un account dell'entità servizio (-ServicePrincipal).

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CustomEnvironment

Ambiente personalizzato da usare per gli ambienti restituiti dall'URL di individuazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DiscoveryUrl

URL di individuazione da cui ottenere le informazioni sui servizi back-end. È necessario specificare anche l'ambiente personalizzato.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Environment

Ambiente cloud a cui connettersi. Il valore predefinito è Pubblico.

Tipo:PowerBIEnvironmentType
Valori accettati:Public, Germany, USGov, China, USGovHigh, USGovMil
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServicePrincipal

Indica di usare un account dell'entità servizio anziché un account utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tenant

Nome tenant o ID tenant contenente l'account dell'entità servizio. Se non specificato, viene usato il tenant 'COMMON'.

Tipo:String
Alias:TenantId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Note