Connect-PowerBIServiceAccount

Modul:

MicrosoftPowerBIMgmt.Profile

Melden Sie sich beim Power BI-Dienst an.

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

Beschreibung

Melden Sie sich bei Power BI-Dienst mit einem Benutzer- oder Dienstprinzipalkonto (Anwendungsschlüssel oder Zertifikat) an. Bei Benutzerkonten wird eine Azure Active Directory (AAD) First-Party Anwendung für die Authentifizierung genutzt. Zum Abmelden des Anrufs "Disconnect-PowerBIServiceAccount"

Beispiele

Beispiel 1

PS C:\> Connect-PowerBIServiceAccount

Meldet sich mit der Benutzerauthentifizierung für die öffentliche Cloud an, wird eine Aufforderung zum Sammeln von Anmeldeinformationen angezeigt.

Beispiel 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Meldet sich bei der Verwendung der Benutzerauthentifizierung für die China-Cloud an, wird eine Aufforderung zum Sammeln von Anmeldeinformationen angezeigt.

Beispiel 3

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

Meldet sich mit einem Dienstprinzipal für die öffentliche Cloud an, wird eine Eingabeaufforderung von Get-Credential angezeigt, um Ihren Benutzernamen (Ihre AAD-Client-ID) und Ihr Kennwort (Ihren geheimen Anwendungsschlüssel) einzugeben.

Beispiel 4

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

Meldet sich mit einem Dienstprinzipal mit einem installierten Zertifikat in der öffentlichen Cloud an. Das Zertifikat muss entweder im CurrentUser- oder LocalMachine-Zertifikatspeicher installiert sein (LocalMachine erfordert Administratorzugriff), wobei ein privater Schlüssel installiert ist.

Parameter

-ApplicationId

Azure Active Directory (AAD)-Anwendungs-ID (auch als Client-ID bezeichnet), die mit einem Zertifikat-Fingerabdruck (-CertificateThumbprint) verwendet werden soll, um sich mit einem Dienstprinzipalkonto (-ServicePrincipal) zu authentifizieren.

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

-CertificateThumbprint

Zertifikat-Fingerabdruck eines installierten Zertifikats, das einer Azure Active Directory -Anwendung (AAD) zugeordnet ist. Das Zertifikat muss entweder in den Persönlichen Zertifikatspeichern "CurrentUser" oder "LocalMachine" (LocalMachine erfordert eine Administratoraufforderung für den Zugriff) mit einem installierten privaten Schlüssel installiert sein.

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

-Credential

PSCredential, die die Azure Active Directory (AAD)-Anwendungsclient-ID (Benutzername) und den geheimen Anwendungsschlüssel (Kennwort) darstellt, um sich mit einem Dienstprinzipalkonto (-ServicePrincipal) zu authentifizieren.

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

-CustomEnvironment

Die benutzerdefinierte Umgebung, die für die von der Discovery-URL zurückgegebenen Umgebungen verwendet werden soll.

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

-DiscoveryUrl

Die Ermittlungs-URL, aus der die Back-End-Dienste-Informationen abgerufen werden sollen. Benutzerdefinierte Umgebung muss ebenfalls bereitgestellt werden.

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

-Environment

Cloudumgebung, mit der eine Verbindung hergestellt werden soll. Der Standardwert ist "Öffentlich".

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

Gibt an, ein Dienstprinzipalkonto zu verwenden, im Gegensatz zu einem Benutzerkonto.

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

-Tenant

Mandantenname oder Mandanten-ID, die das Dienstprinzipalkonto enthält. Wenn nicht angegeben, wird der "COMMON"-Mandant verwendet.

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

Eingaben

None

Ausgaben

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Hinweise

VERWANDTE LINKS