New-PartnerAccessToken

Module:

PartnerCenter

Acquiert un jeton d’accès à partir d’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

Acquiert un jeton d’accès à partir d’Azure Active Directory.

Exemples

Exemple 1 : Génération d’un nouveau jeton d’accès

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

La première commande obtient les informations d’identification du principal de service (identificateur d’application et secret du principal de service), puis les stocke dans la variable $credential. La deuxième commande demande un nouveau jeton d’accès à partir d’Azure Active Directory. Lorsque vous utilisez le paramètre UseAuthorizationCode, vous êtes invité à vous authentifier de manière interactive à l’aide du flux de code d’autorisation. La valeur de l’URI de redirection est générée dynamiquement. Ce processus de génération tente de trouver un port compris entre 8400 et 8999 qui n’est pas utilisé. Une fois qu’un port disponible a été trouvé, la valeur de l’URL de redirection est construite (par exemple, http://localhost:8400). Par conséquent, il est important que vous ayez configuré la valeur de l’URI de redirection pour votre application Azure Active Directory en conséquence.

Exemple 2 : Génération d’un jeton d’accès à l’aide d’un jeton d’actualisation

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'

La première commande obtient les informations d’identification du principal de service (identificateur d’application et secret du principal de service), puis les stocke dans la variable $credential. La troisième commande génère un nouveau jeton d’accès à l’aide des informations d’identification du principal de service stockées dans la variable $credential et le jeton d’actualisation stocké dans la variable $refreshToken pour l’authentification.

Paramètres

-AccessToken

Jeton d’accès pour l’Espace partenaires.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ApplicationId

Identificateur d’application à utiliser pendant l’authentification.

Type:	String
Alias:	ClientId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CertificateThumbprint

Hachage de certificat (empreinte numérique)

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Credential

Informations d’identification qui représentent le principal de service.

Type:	PSCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Environment

Utilisation de l’environnement pour l’authentification.

Type:	EnvironmentName
Alias:	EnvironmentName
Valeurs acceptées:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Module

Module généré par un jeton d’accès.

Type:	ModuleName
Alias:	ModuleName
Valeurs acceptées:	ExchangeOnline, ExchangeOnline
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RefreshToken

Jeton d’actualisation à utiliser pendant l’authentification.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Scopes

Étendues demandées pour accéder à une API protégée.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ServicePrincipal

Indique que ce compte s’authentifie en fournissant les informations d’identification du principal de service.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Tenant

Identificateur du locataire Azure AD.

Type:	String
Alias:	Domain, TenantId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UseAuthorizationCode

Utilisez le flux de code d’autorisation pendant l’authentification.

Type:	SwitchParameter
Alias:	AuthCode
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UseDeviceAuthentication

Utiliser l’authentification par code d’appareil au lieu d’un contrôle de navigateur

Type:	SwitchParameter
Alias:	DeviceCode, DeviceAuth, Device
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

None

Sorties

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