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

Description

從 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

共用方式為