Connect-PowerBIServiceAccount

Modül:

MicrosoftPowerBIMgmt.Profile Module

Power BI hizmetinde oturum açın.

Syntax

User (Varsayılan)

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

Power BI hizmetinde bir kullanıcı veya hizmet sorumlusu hesabıyla (uygulama anahtarı veya sertifika) oturum açın. Kullanıcı hesapları için kimlik doğrulaması için bir Azure Active Directory (AAD) First-Party uygulaması kullanılır. Oturumu kapatmak için Disconnect-PowerBIServiceAccount'u çağırın.

Örnekler

Örnek 1

PS C:\> Connect-PowerBIServiceAccount

Genel bulutta kullanıcı kimlik doğrulaması kullanarak oturum açar, kimlik bilgilerini toplamak için bir istem görüntülenir.

Örnek 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

Çin bulutunda kullanıcı kimlik doğrulaması kullanarak oturum açar, kimlik bilgilerini toplamak için bir istem görüntülenir.

Örnek 3

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

Genel bulutta bir hizmet sorumlusu kullanarak oturum açtığınızda, Get-Credential kullanıcı adınızı (AAD istemci kimliğiniz) ve parolanızı (uygulama gizli anahtarınız) girmeniz için bir istem görüntülenir.

Örnek 4

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

Genel bulutta yüklü bir sertifikaya sahip bir hizmet sorumlusu kullanarak oturum açar. Sertifikanın CurrentUser veya LocalMachine sertifika deposuna (LocalMachine yönetici erişimi gerektirir) özel bir anahtar yüklenmiş olarak yüklenmesi gerekir.

Power BI REST API'yi çağırırken doğrulama için sağlanan Token'ı (ham OAuth 2.0 erişim tokenı/JWT değeri, ön Bearer ek olmadan) kullanın. Bu tokenı bir sır olarak ele alın ve loglara, scriptlere veya komut satırı geçmişine yapıştırmayın.

Örnek 5

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

Parametreler

-ApplicationId

Azure Active Directory (AAD) uygulama kimliği (İstemci Kimliği olarak da bilinir) bir hizmet sorumlusu hesabıyla (-ServicePrincipal) kimlik doğrulaması yapmak için sertifika parmak izi (-CertificateThumbprint) ile birlikte kullanılır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ServicePrincipalCertificate

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CertificateThumbprint

Azure Active Directory (AAD) uygulamasıyla ilişkili yüklü bir sertifikanın sertifika parmak izi. Sertifika, CurrentUser veya LocalMachine kişisel sertifika depolarına yüklenmelidir (LocalMachine erişim için yönetici istemi gerektirir) ve özel anahtar yüklü olmalıdır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ServicePrincipalCertificate

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

PSCredential, bir hizmet sorumlusu hesabıyla (-ServicePrincipal) kimlik doğrulaması yapmak için Azure Active Directory (AAD) uygulama istemci kimliğini (kullanıcı adı) ve uygulama gizli anahtarını (parola) temsil eder.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ServicePrincipal

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

UserAndCredential

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CustomEnvironment

Bulma URL'sinden döndürülen ortamlar için kullanılacak özel ortam.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DiscoveryUrl

Arka uç hizmetleri bilgilerinin alınacağı bulma URL'si. Özel ortam da sağlanmalıdır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Environment

Bağlanacak bulut ortamı. Varsayılan, Genel'dir.

Parametre özellikleri

Tür:	PowerBIEnvironmentType
Default value:	None
Kabul edilen değerler:	Public, Germany, USGov, China, USGovHigh, USGovMil
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ServicePrincipal

Kullanıcı hesabının aksine bir hizmet sorumlusu hesabı kullanmayı gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ServicePrincipal

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

ServicePrincipalCertificate

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Tenant

Hizmet sorumlusu hesabını içeren kiracı adı veya kiracı kimliği. Belirtilmezse, 'COMMON' kiracı kullanılır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	KiracıID

Parametre kümeleri

ServicePrincipal

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

ServicePrincipalCertificate

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Token

kimlik doğrulama için JWT erişim tokenı; sadece token değerini ilet, bu değer API çağrıları için başlık olarak gönderilecek Authorization: Bearer <token> .

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

BringYourOwnToken

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Çıkışlar

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile