Udostępnij za pośrednictwem


Connect-PowerBIServiceAccount

Zaloguj się do usługa 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ługa 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 używana do uwierzytelniania. Aby wylogować się z wywołania Disconnect-PowerBIServiceAccount.

Przykłady

Przykład 1

PS C:\> Connect-PowerBIServiceAccount

W dziennikach 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

Zaloguje się przy użyciu uwierzytelniania użytkownika 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)

Zaloguje się 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) (nazywany również identyfikatorem klienta) używany z odciskiem palca certyfikatu (-CertificateThumbprint) do uwierzytelniania przy użyciu konta jednostki usługi (-ServicePrincipal).

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

-CertificateThumbprint

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

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

-Credential

PsCredential reprezentujący identyfikator klienta aplikacji usługi Azure Active Directory (AAD) i klucz tajny aplikacji (hasło) do uwierzytelniania przy użyciu konta jednostki usługi (-ServicePrincipal).

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

-CustomEnvironment

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

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

-DiscoveryUrl

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

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

-Environment

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

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

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

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

-Tenant

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

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

Dane wejściowe

None

Dane wyjściowe

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Uwagi