共用方式為


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