Connect-PowerBIServiceAccount

Modul:

MicrosoftPowerBIMgmt.Profile Module

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

Syntax

User (Výchozí)

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

BringYourOwnToken

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

Description

Přihlaste se ke službě Power BI pomocí uživatelského účtu nebo účtu 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, zavolejte na 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 ve veřejném cloudu, od Get-Credential se zobrazí výzva k zadání uživatelského jména (ID klienta AAD) a hesla (tajného klíče aplikace).

Příklad 4

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

Přihlásí 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.

Použijte poskytnutý token (surový přístupový token OAuth 2.0/JWT hodnotu, bez prefixu Bearer ) pro autentizaci při volání Power BI REST API. Tento token považujte za tajemství a nevkládejte ho do logů, skriptů ani historie příkazového řádku.

Příklad 5

PS C:\> Connect-PowerBIServiceAccount -Token eyJhbGciOiJIUzI1NiJ9.fake_payload_and_signature_redacted_for_example

Parametry

-ApplicationId

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ServicePrincipalCertificate

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ServicePrincipalCertificate

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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).

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ServicePrincipal

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

UserAndCredential

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CustomEnvironment

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DiscoveryUrl

Adresa URL zjišťování, ze které se mají získat informace o back-endových službách. Musí být dodáno i vlastní prostředí.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Environment

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

Vlastnosti parametru

Typ:	PowerBIEnvironmentType
Default value:	None
Přípustné hodnoty:	Public, Germany, USGov, China, USGovHigh, USGovMil
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ServicePrincipal

Označuje, že se má použít instanční účet, nikoli uživatelský účet.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ServicePrincipal

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ServicePrincipalCertificate

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Tenant

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Identifikátor nájemce (TenantId)

Sady parametrů

ServicePrincipal

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

ServicePrincipalCertificate

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Token

JWT přístupový token pro autentizaci; předávat pouze hodnotu tokenu, která bude odeslána jako hlavička Authorization: Bearer <token> pro volání API.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

BringYourOwnToken

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Výstupy

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile