Udostępnij przez

Connect-PowerBIServiceAccount

Moduł:
MicrosoftPowerBIMgmt.Profile Module

Zaloguj się do usługi Power BI.

Składnia

User (Domyślna) 

Connect-PowerBIServiceAccount
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipal 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-ServicePrincipal]
    [-Tenant <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

UserAndCredential 

Connect-PowerBIServiceAccount
    -Credential <PSCredential>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

ServicePrincipalCertificate 

Connect-PowerBIServiceAccount
    -CertificateThumbprint <String>
    -ApplicationId <String>
    [-Environment <PowerBIEnvironmentType>]
    [-CustomEnvironment <String>]
    [-ServicePrincipal]
    [-Tenant <String>]
    [-DiscoveryUrl <String>]
    [<CommonParameters>]

Opis

Zaloguj się do usługi Power BI przy użyciu konta użytkownika lub głównego konta usługi (klucza aplikacji lub certyfikatu). W przypadku kont użytkowników aplikacja usługi Azure Active Directory (AAD) First-Party jest uwierzytelnianiem. Aby się wylogować, wywołaj metodę 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)

Loguje się przy użyciu jednostki usługi w chmurze publicznej, zostanie wyświetlony monit z Get-Credential o wprowadzenie nazwy użytkownika (identyfikatora klienta usługi AAD) i hasła (tajnego klucza aplikacji).

Przykład 4

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

Loguje się przy użyciu jednostki usługi z zainstalowanym certyfikatem do chmury 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).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ServicePrincipalCertificate
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ServicePrincipalCertificate
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Credential

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

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ServicePrincipal
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
UserAndCredential
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CustomEnvironment

Środowisko niestandardowe, które ma być używane dla środowisk zwracanych z adresu URL odnajdywania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DiscoveryUrl

Adres URL odnajdywania, z którego mają być pobierane informacje o usługach zaplecza. Konieczne jest również dostarczenie środowiska niestandardowego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Environment

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

Właściwości parametru

Typ:PowerBIEnvironmentType
Domyślna wartość:None
Dopuszczalne wartości:Public, Germany, USGov, China, USGovHigh, USGovMil
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ServicePrincipal

Wskazuje, aby używać konta jednostki usługi, a nie konta użytkownika.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ServicePrincipal
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ServicePrincipalCertificate
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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".

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator najemcy

Zestawy parametrów

ServicePrincipal
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ServicePrincipalCertificate
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile