New-PartnerAccessToken
Získá přístupový token z Azure Active Directory.
Syntaxe
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
Získá přístupový token z Azure Active Directory.
Příklady
Příklad 1: Generování nového přístupového tokenu
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
První příkaz získá přihlašovací údaje instančního objektu (identifikátor aplikace a tajný klíč instančního objektu) a pak je uloží do proměnné $credential. Druhý příkaz požádá o nový přístupový token z Azure Active Directory. Při použití parametru UseAuthorizationCode
budete vyzváni k interaktivnímu ověřování pomocí toku autorizačního kódu. Hodnota identifikátoru URI přesměrování se vygeneruje dynamicky. Tento proces generování se pokusí najít port mezi 8400 a 8999, který se nepoužívá. Po nalezení dostupného portu se vytvoří hodnota adresy URL pro přesměrování (např. http://localhost:8400
). Proto je důležité, abyste odpovídajícím způsobem nakonfigurovali hodnotu identifikátoru URI přesměrování pro vaši aplikaci Azure Active Directory.
Příklad 2: Generování přístupového tokenu pomocí obnovovacího tokenu
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'
První příkaz získá přihlašovací údaje instančního objektu (identifikátor aplikace a tajný klíč instančního objektu) a pak je uloží do proměnné $credential. Třetí příkaz vygeneruje nový přístupový token pomocí přihlašovacích údajů instančního objektu uložených v proměnné $credential a obnovovacího tokenu uloženého v proměnné $refreshToken pro ověření.
Parametry
-AccessToken
Přístupový token pro Partnerské centrum.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ApplicationId
Identifikátor aplikace, který se má použít při ověřování.
Typ: | String |
Aliasy: | ClientId |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CertificateThumbprint
Hash certifikátu (kryptografický otisk)
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Credential
Přihlašovací údaje, které představují instanční objekt.
Typ: | PSCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Environment
Prostředí se používá k ověřování.
Typ: | EnvironmentName |
Aliasy: | EnvironmentName |
Přípustné hodnoty: | AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Module
Modul, který se generuje přístupový token.
Typ: | ModuleName |
Aliasy: | ModuleName |
Přípustné hodnoty: | ExchangeOnline, ExchangeOnline |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-RefreshToken
Obnovovací token, který se má použít při ověřování.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Scopes
Obory požadované pro přístup k chráněnému rozhraní API
Typ: | String[] |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ServicePrincipal
Označuje, že se tento účet ověřuje zadáním přihlašovacích údajů instančního objektu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Tenant
Identifikátor tenanta Azure AD.
Typ: | String |
Aliasy: | Domain, TenantId |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-UseAuthorizationCode
Během ověřování použijte tok autorizačního kódu.
Typ: | SwitchParameter |
Aliasy: | AuthCode |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-UseDeviceAuthentication
Použití ověřování kódu zařízení místo ovládacího prvku prohlížeče
Typ: | SwitchParameter |
Aliasy: | DeviceCode, DeviceAuth, Device |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
None
Výstupy
Microsoft.Store.PartnerCenter.PowerShell.Models.Authentication.AuthResult