Connect-PowerBIServiceAccount

Moduł:

MicrosoftPowerBIMgmt.Profile

Zaloguj się do usługi Power BI.

Składnia

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

Opis

Zaloguj się do usługi Power BI przy użyciu konta użytkownika lub jednostki usługi (klucza aplikacji lub certyfikatu). W przypadku kont użytkowników aplikacja usługi Azure Active Directory (AAD) First-Party jest uwierzytelnianiem. Aby wylogować się z wywołania Disconnect-PowerBIServiceAccount.

Przykłady

Przykład 1

PS C:\> Connect-PowerBIServiceAccount

Po zalogowaniu się przy użyciu uwierzytelniania użytkownika w chmurze publicznej zostanie wyświetlony monit o zebranie poświadczeń.

Przykład 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Po zalogowaniu się przy użyciu uwierzytelniania użytkowników w chmurze w Chinach zostanie wyświetlony monit o zebranie poświadczeń.

Przykład 3

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

W dzienniku przy użyciu jednostki usługi w chmurze publicznej zostanie wyświetlony monit z Get-Credential, aby wprowadzić nazwę użytkownika (identyfikator klienta usługi AAD) i hasło (klucz tajny aplikacji).

Przykład 4

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

Rejestruje się przy użyciu jednostki usługi z zainstalowanym certyfikatem w chmurze publicznej. Certyfikat musi być zainstalowany w magazynie certyfikatów CurrentUser lub LocalMachine (LocalMachine wymaga dostępu administratora) z zainstalowanym kluczem prywatnym.

Parametry

-ApplicationId

Identyfikator aplikacji usługi Azure Active Directory (AAD) (znany również jako identyfikator klienta) do użycia z odciskiem palca certyfikatu (-CertificateThumbprint) do uwierzytelniania przy użyciu konta jednostki usługi (-ServicePrincipal).

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CertificateThumbprint

Odcisk palca certyfikatu zainstalowanego certyfikatu skojarzonego z aplikacją usługi Azure Active Directory (AAD). Certyfikat musi być zainstalowany w magazynach certyfikatów osobistych CurrentUser lub LocalMachine (LocalMachine wymaga monitu administratora o dostęp) z zainstalowanym kluczem prywatnym.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Credential

PSCredential reprezentujący identyfikator klienta aplikacji (nazwa użytkownika) aplikacji (nazwa użytkownika) i klucz tajny aplikacji (hasło) do uwierzytelniania przy użyciu konta jednostki usługi (-ServicePrincipal).

Typ:	PSCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CustomEnvironment

Środowisko niestandardowe do użycia dla środowisk zwróconych z adresu URL odnajdywania.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DiscoveryUrl

Adres URL odnajdywania umożliwiający pobranie informacji o usługach zaplecza. Należy również podać środowisko niestandardowe.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Environment

Środowisko chmury do nawiązywania połączenia z. Wartość domyślna to Publiczna.

Typ:	PowerBIEnvironmentType
Dopuszczalne wartości:	Public, Germany, USGov, China, USGovHigh, USGovMil
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ServicePrincipal

Wskazuje, aby używać konta jednostki usługi, w przeciwieństwie do konta użytkownika.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Tenant

Nazwa dzierżawy lub identyfikator dzierżawy zawierający konto jednostki usługi. Jeśli nie zostanie określony, zostanie użyta dzierżawa "COMMON".

Typ:	String
Aliasy:	TenantId
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Uwagi

POWIĄZANE LINKI