Connect-PowerBIServiceAccount

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 a servizio Power BI con un account utente o un'entità servizio (chiave dell'applicazione o certificato). Per gli account utente, un'applicazione di First-Party 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. Verrà visualizzata una richiesta 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 come 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 l'autenticazione con un account dell'entità servizio (-ServicePrincipal).

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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).

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

-CustomEnvironment

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

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

-DiscoveryUrl

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

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

-Environment

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

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 di usare un account dell'entità servizio, anziché un account utente.

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

-Tenant

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

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

Input

None

Output

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Note

COLLEGAMENTI CORRELATI