New-PartnerAccessToken

参考

模块:: PartnerCenter

从 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变量中。第二个命令将从 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变量中。第三个命令将使用存储在$credential变量中的服务主体凭据和存储在 $refreshToken 变量中的刷新令牌来生成新的访问令牌，以便进行身份验证。

参数

-AccessToken

合作伙伴中心的访问令牌。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationId

身份验证期间要使用的应用程序标识符。

类型:	String
别名:	ClientId
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-CertificateThumbprint

证书哈希（指纹）

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Credential

表示服务主体的凭据。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Environment

环境用于身份验证。

类型:	EnvironmentName
别名:	EnvironmentName
接受的值:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Module

正在生成访问令牌的模块。

类型:	ModuleName
别名:	ModuleName
接受的值:	ExchangeOnline, ExchangeOnline
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RefreshToken

身份验证期间要使用的刷新令牌。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Scopes

请求访问受保护 API 的范围。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ServicePrincipal

指示此帐户通过提供服务主体凭据进行身份验证。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Tenant

Azure AD 租户的标识符。

类型:	String
别名:	Domain, TenantId
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-UseAuthorizationCode

在身份验证期间使用授权代码流。

类型:	SwitchParameter
别名:	AuthCode
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseDeviceAuthentication

使用设备代码身份验证而不是浏览器控件

类型:	SwitchParameter
别名:	DeviceCode, DeviceAuth, Device
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

Microsoft.Store.PartnerCenter.PowerShell.Models.Authentication.AuthResult

通过