New-PartnerAccessToken
Azure Active Directory からアクセス トークンを取得します。
構文
New-PartnerAccessToken
-AccessToken <String>
-ApplicationId <String>
[-Credential <PSCredential>]
[-Environment <EnvironmentName>]
-Scopes <String[]>
[-Tenant <String>]
[<CommonParameters>] New-PartnerAccessToken
[-ApplicationId <String>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-Environment <EnvironmentName>]
[-Module <ModuleName>]
-RefreshToken <String>
-Scopes <String[]>
[-ServicePrincipal]
[-Tenant <String>]
[<CommonParameters>] New-PartnerAccessToken
-ApplicationId <String>
-Credential <PSCredential>
[-Environment <EnvironmentName>]
-Scopes <String[]>
[-ServicePrincipal]
-Tenant <String>
[-UseAuthorizationCode]
[<CommonParameters>] New-PartnerAccessToken
-ApplicationId <String>
-CertificateThumbprint <String>
[-Environment <EnvironmentName>]
-Scopes <String[]>
[-ServicePrincipal]
-Tenant <String>
[-UseAuthorizationCode]
[<CommonParameters>] New-PartnerAccessToken
-ApplicationId <String>
[-Environment <EnvironmentName>]
-Scopes <String[]>
[-Tenant <String>]
[-UseAuthorizationCode]
[-UseDeviceAuthentication]
[<CommonParameters>] New-PartnerAccessToken
[-Environment <EnvironmentName>]
-Module <ModuleName>
[-RefreshToken <String>]
[-Tenant <String>]
[-UseAuthorizationCode]
[<CommonParameters>] 説明
Azure Active Directory からアクセス トークンを取得します。
例
例 1: 新しいアクセス トークンの生成
PS C:\> $credential = Get-Credential
PS C:\> New-PartnerAccessToken -ApplicationId 'xxxx-xxxx-xxxx-xxxx' -Scopes 'https://api.partnercenter.microsoft.com/user_impersonation' -ServicePrincipal -Credential $credential -Tenant 'xxxx-xxxx-xxxx-xxxx' -UseAuthorizationCode最初のコマンドは、サービス プリンシパルの資格情報 (アプリケーション識別子とサービス プリンシパル シークレット) を取得し、$credential変数に格納します。 2 番目のコマンドは、Azure Active Directory に新しいアクセス トークンを要求します。
UseAuthorizationCode パラメーターを使用すると、認証コード フローを使用して対話形式で認証するように求められます。 リダイレクト URI 値は動的に生成されます。 この生成プロセスでは、使用されていない 8400 から 8999 までのポートの検索が試みられます。 使用可能なポートが見つかると、リダイレクト URL 値が構築されます (例: http://localhost:8400)。 そのため、それに応じて Azure Active Directory アプリケーションのリダイレクト URI 値を構成することが重要です。
例 2: 更新トークンを使用したアクセス トークンの生成
PS C:\> $credential = Get-Credential
PS C:\> $refreshToken = '<refreshToken>'
PS C:\> New-PartnerAccessToken -ApplicationId 'xxxx-xxxx-xxxx-xxxx' -Credential $credential -RefreshToken $refreshToken -Scopes 'https://api.partnercenter.microsoft.com/user_impersonation' -ServicePrincipal -Tenant 'xxxx-xxxx-xxxx-xxxx'最初のコマンドは、サービス プリンシパルの資格情報 (アプリケーション識別子とサービス プリンシパル シークレット) を取得し、$credential変数に格納します。 3 番目のコマンドは、$credential変数に格納されているサービス プリンシパルの資格情報と、認証のために $refreshToken 変数に格納されている更新トークンを使用して、新しいアクセス トークンを生成します。
パラメーター
-AccessToken
パートナー センターのアクセス トークン。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ApplicationId
認証時に使用するアプリケーション識別子。
| 型: | String |
| Aliases: | ClientId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CertificateThumbprint
証明書ハッシュ (拇印)
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
サービス プリンシパルを表す資格情報。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Environment
認証に使用する環境。
| 型: | EnvironmentName |
| Aliases: | EnvironmentName |
| 指定可能な値: | AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Module
アクセス トークンが生成されているモジュール。
| 型: | ModuleName |
| Aliases: | ModuleName |
| 指定可能な値: | ExchangeOnline, ExchangeOnline |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RefreshToken
認証時に使用する更新トークン。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Scopes
保護された API へのアクセスを要求されたスコープ。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServicePrincipal
このアカウントがサービス プリンシパルの資格情報を指定して認証されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Tenant
Azure AD テナントの識別子。
| 型: | String |
| Aliases: | Domain, TenantId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseAuthorizationCode
認証時に承認コード フローを使用します。
| 型: | SwitchParameter |
| Aliases: | AuthCode |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseDeviceAuthentication
ブラウザー コントロールの代わりにデバイス コード認証を使用する
| 型: | SwitchParameter |
| Aliases: | DeviceCode, DeviceAuth, Device |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
Microsoft.Store.PartnerCenter.PowerShell.Models.Authentication.AuthResult