Connect-PowerBIServiceAccount

Module:

MicrosoftPowerBIMgmt.Profile

Meld u aan bij de Power BI-service.

Syntaxis

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

Als u zich aanmeldt met behulp van gebruikersverificatie voor de openbare cloud, wordt er een prompt weergegeven om referenties te verzamelen.

Voorbeeld 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Als u zich aanmeldt met behulp van gebruikersverificatie voor de China-cloud, wordt er een prompt weergegeven om referenties te verzamelen.

Voorbeeld 3

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

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

Voorbeeld 4

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

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

Parameters

-ApplicationId

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

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CertificateThumbprint

Vingerafdruk van certificaat 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
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Credential

PSCredential die de client-id (gebruikersnaam) van de AAD-toepassing (Azure Active Directory) en de geheime sleutel van de toepassing (wachtwoord) vertegenwoordigt voor verificatie met een service-principal-account (-ServicePrincipal).

Type:	PSCredential
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DiscoveryUrl

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Environment

Cloudomgeving om verbinding mee te maken. De standaardwaarde is openbaar.

Type:	PowerBIEnvironmentType
Geaccepteerde waarden:	Public, Germany, USGov, China, USGovHigh, USGovMil
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ServicePrincipal

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Tenant

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

Type:	String
Aliassen:	TenantId
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

None

Uitvoerwaarden

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Notities

VERWANTE KOPPELINGEN