New-PartnerAccessToken
從 Azure Active Directory 取得存取令牌。
語法
AccessToken
New-PartnerAccessToken
-AccessToken <String>
-ApplicationId <String>
-Scopes <String[]>
[-Credential <PSCredential>]
[-Environment <EnvironmentName>]
[-Tenant <String>]
[<CommonParameters>]
RefreshToken
New-PartnerAccessToken
-RefreshToken <String>
-Scopes <String[]>
[-ApplicationId <String>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-Environment <EnvironmentName>]
[-Module <ModuleName>]
[-ServicePrincipal]
[-Tenant <String>]
[<CommonParameters>]
ServicePrincipal
New-PartnerAccessToken
-ApplicationId <String>
-Credential <PSCredential>
-Scopes <String[]>
-Tenant <String>
[-Environment <EnvironmentName>]
[-ServicePrincipal]
[-UseAuthorizationCode]
[<CommonParameters>]
ServicePrincipalCertificate
New-PartnerAccessToken
-ApplicationId <String>
-CertificateThumbprint <String>
-Scopes <String[]>
-Tenant <String>
[-Environment <EnvironmentName>]
[-ServicePrincipal]
[-UseAuthorizationCode]
[<CommonParameters>]
User
New-PartnerAccessToken
-ApplicationId <String>
-Scopes <String[]>
[-Environment <EnvironmentName>]
[-Tenant <String>]
[-UseAuthorizationCode]
[-UseDeviceAuthentication]
[<CommonParameters>]
ByModule
New-PartnerAccessToken
-Module <ModuleName>
[-Environment <EnvironmentName>]
[-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
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccessToken
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ApplicationId
身份驗證期間要使用的應用程式識別碼。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 用戶端ID |
參數集
AccessToken
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ServicePrincipal
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ServicePrincipalCertificate
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
User
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CertificateThumbprint
憑證哈希 (指紋)
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
RefreshToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
表示服務主體的憑據。
參數屬性
| 類型: | PSCredential
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccessToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
RefreshToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Environment
用於身份驗證的環境。
參數屬性
| 類型: | EnvironmentName
|
| 預設值: | None |
| 接受的值: | AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | EnvironmentName |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Module
正在生成訪問令牌的模組。
參數屬性
| 類型: | ModuleName
|
| 預設值: | None |
| 接受的值: | ExchangeOnline |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 模組名稱 |
參數集
RefreshToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RefreshToken
身份驗證期間要使用的刷新令牌。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
RefreshToken
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Scopes
請求訪問受保護 API 的範圍。
參數屬性
| 類型: | String[]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccessToken
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
RefreshToken
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ServicePrincipal
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ServicePrincipalCertificate
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
User
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ServicePrincipal
表示此帳戶會藉由提供服務主體認證來驗證。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
RefreshToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ServicePrincipalCertificate
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Tenant
Azure AD 租戶的標識碼。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 網域, 租戶識別碼 (TenantId) |
參數集
AccessToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
RefreshToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
User
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ByModule
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseAuthorizationCode
在身份驗證期間使用授權代碼流。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 身份驗證代碼 |
參數集
ServicePrincipal
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ServicePrincipalCertificate
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
User
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ByModule
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseDeviceAuthentication
使用設備代碼身份驗證而不是瀏覽器控制項
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | DeviceCode, DeviceAuth, 裝置 |
參數集
User
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
None
輸出
Microsoft.Store.PartnerCenter.PowerShell.Models.Authentication.AuthResult