Connect-PowerBIServiceAccount
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 ChinaChina クラウドに対するユーザー認証を使用してログインすると、資格情報を収集するためのプロンプトが表示されます。
例 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