Delen via


Connect-PowerBIServiceAccount

Meld u aan bij het Power BI-service.

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

Meld u aan bij Power BI-service met een gebruikers- of service-principal-account (toepassingssleutel of certificaat). Voor gebruikersaccounts wordt een AAD-First-Party-toepassing (Azure Active Directory) gebruikt voor verificatie. Meld u af bij Disconnect-PowerBIServiceAccount.

Voorbeelden

Voorbeeld 1

PS C:\> Connect-PowerBIServiceAccount

Logboeken bij het gebruik van gebruikersverificatie in de openbare cloud. Er wordt een prompt weergegeven om referenties te verzamelen.

Voorbeeld 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Inloggen met behulp van gebruikersverificatie in de China-cloud, wordt een prompt weergegeven om referenties te verzamelen.

Voorbeeld 3

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

Er wordt een prompt weergegeven van Get-Credential om uw gebruikersnaam (uw AAD-client-id) en wachtwoord (uw geheime sleutel van de toepassing) in te voeren met behulp van een service-principal in de openbare cloud.

Voorbeeld 4

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

Meldt u zich aan met behulp van een service-principal met een geïnstalleerd certificaat in de openbare cloud. Het certificaat moet worden geïnstalleerd in het CurrentUser- of LocalMachine-certificaatarchief (LocalMachine vereist beheerderstoegang) waarop een persoonlijke sleutel is geïnstalleerd.

Parameters

-ApplicationId

Toepassings-id van Azure Active Directory (AAD) (ook wel client-id genoemd) die moet worden gebruikt met een certificaatvingerafdruk (-CertificateThumbprint) om te verifiëren met een service-principal-account (-ServicePrincipal).

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

-CertificateThumbprint

Certificaatvingerafdruk van een geïnstalleerd certificaat dat is gekoppeld aan een AAD-toepassing (Azure Active Directory). Het certificaat moet zijn geïnstalleerd in de persoonlijke certificaatarchieven CurrentUser of LocalMachine (LocalMachine vereist een beheerdersprompt om toegang te krijgen) met een persoonlijke sleutel geïnstalleerd.

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

-Credential

PSCredential die de client-id (gebruikersnaam) van de Azure Active Directory-toepassing (gebruikersnaam) en de geheime sleutel van de toepassing (wachtwoord) vertegenwoordigt om te verifiëren met een service-principal-account (-ServicePrincipal).

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

-CustomEnvironment

De aangepaste omgeving die moet worden gebruikt voor de omgevingen die worden geretourneerd door de detectie-URL.

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

-DiscoveryUrl

De detectie-URL voor het ophalen van de informatie over de back-endservices. Er moet ook een aangepaste omgeving worden opgegeven.

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

-Environment

Cloudomgeving waarmee verbinding moet worden gemaakt. De standaardwaarde is openbaar.

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

Geeft aan dat u een service-principal-account gebruikt, in plaats van een gebruikersaccount.

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

-Tenant

Tenantnaam of tenant-id met het service-principal-account. Als dit niet is opgegeven, wordt de 'COMMON'-tenant gebruikt.

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

Invoerwaarden

None

Uitvoerwaarden

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Notities