New-PartnerAccessToken

Modulo:

PartnerCenter

Acquisisce un token di accesso da Azure Active Directory.

Sintassi

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

Descrizione

Acquisisce un token di accesso da Azure Active Directory.

Esempio

Esempio 1: Generazione di un nuovo token di accesso

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

Il primo comando ottiene le credenziali dell'entità servizio (identificatore dell'applicazione e segreto dell'entità servizio) e quindi le archivia nella variabile $credential. Il secondo comando richiederà un nuovo token di accesso da Azure Active Directory. Quando si usa il parametro UseAuthorizationCode verrà richiesto di eseguire l'autenticazione in modo interattivo usando il flusso del codice di autorizzazione. Il valore dell'URI di reindirizzamento verrà generato in modo dinamico. Questo processo di generazione tenterà di trovare una porta compresa tra 8400 e 8999 che non è in uso. Dopo aver trovato una porta disponibile, il valore dell'URL di reindirizzamento verrà costruito ,ad esempio http://localhost:8400. È quindi importante aver configurato di conseguenza il valore dell'URI di reindirizzamento per l'applicazione Azure Active Directory.

Esempio 2: Generazione di un token di accesso con un token di aggiornamento

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'

Il primo comando ottiene le credenziali dell'entità servizio (identificatore dell'applicazione e segreto dell'entità servizio) e quindi le archivia nella variabile $credential. Il terzo comando genererà un nuovo token di accesso usando le credenziali dell'entità servizio archiviate nella variabile $credential e il token di aggiornamento archiviato nella variabile $refreshToken per l'autenticazione.

Parametri

-AccessToken

Token di accesso per il Centro per i partner.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ApplicationId

Identificatore dell'applicazione da usare durante l'autenticazione.

Tipo:	String
Alias:	ClientId
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CertificateThumbprint

Hash del certificato (identificazione personale)

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

Credenziali che rappresentano l'entità servizio.

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Environment

L'ambiente usato per l'autenticazione.

Tipo:	EnvironmentName
Alias:	EnvironmentName
Valori accettati:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Module

Modulo generato da un token di accesso.

Tipo:	ModuleName
Alias:	ModuleName
Valori accettati:	ExchangeOnline, ExchangeOnline
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RefreshToken

Token di aggiornamento da usare durante l'autenticazione.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Scopes

Ambiti richiesti per accedere a un'API protetta.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServicePrincipal

Indica che questo account viene autenticato fornendo le credenziali dell'entità servizio.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Tenant

Identificatore del tenant di Azure AD.

Tipo:	String
Alias:	Domain, TenantId
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UseAuthorizationCode

Usare il flusso del codice di autorizzazione durante l'autenticazione.

Tipo:	SwitchParameter
Alias:	AuthCode
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UseDeviceAuthentication

Usare l'autenticazione del codice del dispositivo anziché un controllo del browser

Tipo:	SwitchParameter
Alias:	DeviceCode, DeviceAuth, Device
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

None

Output

Microsoft.Store.PartnerCenter.PowerShell.Models.Authentication.AuthResult