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

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 とも呼ばれます)。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CertificateThumbprint

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

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

型:PSCredential
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CustomEnvironment

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DiscoveryUrl

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Environment

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

型:PowerBIEnvironmentType
指定可能な値:Public, Germany, USGov, China, USGovHigh, USGovMil
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicePrincipal

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

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Tenant

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

型:String
Aliases:TenantId
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

Microsoft.PowerBI.Common.Abstractions.Interfaces.IPowerBIProfile

メモ