次の方法で共有

Connect-PowerBIServiceAccount

  • リファレンス
モジュール:
MicrosoftPowerBIMgmt.Profile

Power BI サービスにログインします。

構文

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

説明

ユーザーまたはサービス プリンシパル アカウント (アプリケーション キーまたは証明書) を使用してPower BI サービスにログインします。 ユーザー アカウントの場合、Azure Active Directory (AAD) First-Party アプリケーションが認証に利用されます。 ログアウトするには、Disconnect-PowerBIServiceAccount を呼び出します。

例

例 1

PS C:\> Connect-PowerBIServiceAccount

パブリック クラウドに対するユーザー認証を使用してログインすると、資格情報を収集するためのプロンプトが表示されます。

例 2

PS C:\> Connect-PowerBIServiceAccount -Environment China

中国クラウドに対するユーザー認証を使用してログインすると、資格情報を収集するためのプロンプトが表示されます。

例 3

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

パブリック クラウドに対してサービス プリンシパルを使用してログインすると、ユーザー名 (AAD クライアント ID) とパスワード (アプリケーション シークレット キー) を入力するように求めるプロンプトがGet-Credentialから表示されます。

例 4

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

証明書がインストールされたサービス プリンシパルを使用してパブリック クラウドにログインします。 証明書は、秘密キーがインストールされた CurrentUser または LocalMachine 証明書ストアにインストールする必要があります (LocalMachine には管理者アクセスが必要です)。

パラメーター

-ApplicationId

サービス プリンシパル アカウント (-ServicePrincipal) で認証するために証明書拇印 (-CertificateThumbprint) と共に使用される Azure Active Directory (AAD) アプリケーション ID (クライアント ID とも呼ばれます)。

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

-CertificateThumbprint

Azure Active Directory (AAD) アプリケーションに関連付けられているインストール済み証明書の証明書拇印。 証明書は、秘密キーがインストールされた CurrentUser または LocalMachine の個人証明書ストアにインストールする必要があります (LocalMachine では、アクセスするには管理者プロンプトが必要です)。

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

-Credential

サービス プリンシパル アカウント (-ServicePrincipal) で認証する Azure Active Directory (AAD) アプリケーション クライアント ID (ユーザー名) とアプリケーション シークレット キー (パスワード) を表す PSCredential。

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

-CustomEnvironment

検出 URL から返される環境に使用するカスタム環境。

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

-DiscoveryUrl

バックエンド サービス情報を取得する探索 URL。 カスタム環境も指定する必要があります。

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

-Environment

接続するクラウド環境。 既定値は Public です。

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

ユーザー アカウントではなく、サービス プリンシパル アカウントを使用することを示します。

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

-Tenant

サービス プリンシパル アカウントを含むテナント名またはテナント ID。 指定しない場合は、"COMMON" テナントが使用されます。

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

入力

None

出力

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

メモ