Sdílet prostřednictvím


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