Sdílet prostřednictvím


Connect-PowerBIServiceAccount

Přihlaste se ke službě Power BI.

Syntaxe

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

Přihlaste se ke službě Power BI pomocí účtu uživatele nebo instančního objektu (klíč aplikace nebo certifikát). U uživatelských účtů se k ověřování využívá First-Party aplikace Azure Active Directory (AAD). Chcete-li se odhlásit volání Disconnect-PowerBIServiceAccount.

Příklady

Příklad 1

PS C:\> Connect-PowerBIServiceAccount

Přihlásí se pomocí ověřování uživatelů ve veřejném cloudu. Zobrazí se výzva ke shromažďování přihlašovacích údajů.

Příklad 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Přihlásí se pomocí ověřování uživatelů v cloudu Čína. Zobrazí se výzva ke shromažďování přihlašovacích údajů.

Příklad 3

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

Přihlásí se pomocí instančního objektu pro veřejný cloud. Zobrazí se výzva z Get-Credential k zadání uživatelského jména (ID klienta AAD) a hesla (tajný klíč aplikace).

Příklad 4

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

Protokoluje se pomocí instančního objektu s nainstalovaným certifikátem do veřejného cloudu. Certifikát musí být nainstalovaný v úložišti certifikátů CurrentUser nebo LocalMachine (LocalMachine vyžaduje přístup správce) s nainstalovaným privátním klíčem.

Parametry

-ApplicationId

ID aplikace Azure Active Directory (AAD), které se má použít s kryptografickým otiskem certifikátu (-CertificateThumbprint) k ověření pomocí účtu instančního objektu (-ServicePrincipal).

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CertificateThumbprint

Kryptografický otisk certifikátu nainstalovaného certifikátu přidruženého k aplikaci Azure Active Directory (AAD). Certifikát musí být nainstalovaný v úložištích osobních certifikátů CurrentUser nebo LocalMachine (LocalMachine vyžaduje výzvu správce pro přístup) s nainstalovaným privátním klíčem.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

PSCredential představující ID klienta aplikace Azure Active Directory (AAD) (uživatelské jméno) a tajný klíč aplikace (heslo) pro ověření pomocí účtu instančního objektu (-ServicePrincipal).

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CustomEnvironment

Vlastní prostředí, které se má použít pro prostředí vrácená z adresy URL zjišťování.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DiscoveryUrl

Adresa URL zjišťování pro získání informací o back-endových službách. Musí se také zadat vlastní prostředí.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Environment

Cloudové prostředí pro připojení. Výchozí hodnota je Veřejná.

Typ:PowerBIEnvironmentType
Přípustné hodnoty:Public, Germany, USGov, China, USGovHigh, USGovMil
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServicePrincipal

Označuje použití instančního účtu na rozdíl od uživatelského účtu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tenant

Název tenanta nebo ID tenanta obsahující účet instančního objektu. Pokud není zadaný, použije se tenant COMMON.

Typ:String
Aliasy:TenantId
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

Poznámky