New-PartnerAccessToken

Module:

PartnerCenter Module

Acquires an access token from Azure Active Directory.

New-PartnerAccessToken
 -AccessToken <String>
 -ApplicationId <String>
 -Scopes <String[]>
 [-Credential <PSCredential>]
 [-Environment <EnvironmentName>]
 [-Tenant <String>]
 [<CommonParameters>]

New-PartnerAccessToken
 -RefreshToken <String>
 -Scopes <String[]>
 [-ApplicationId <String>]
 [-CertificateThumbprint <String>]
 [-Credential <PSCredential>]
 [-Environment <EnvironmentName>]
 [-Module <ModuleName>]
 [-ServicePrincipal]
 [-Tenant <String>]
 [<CommonParameters>]

New-PartnerAccessToken
 -ApplicationId <String>
 -Credential <PSCredential>
 -Scopes <String[]>
 -Tenant <String>
 [-Environment <EnvironmentName>]
 [-ServicePrincipal]
 [-UseAuthorizationCode]
 [<CommonParameters>]

New-PartnerAccessToken
 -ApplicationId <String>
 -CertificateThumbprint <String>
 -Scopes <String[]>
 -Tenant <String>
 [-Environment <EnvironmentName>]
 [-ServicePrincipal]
 [-UseAuthorizationCode]
 [<CommonParameters>]

New-PartnerAccessToken
 -ApplicationId <String>
 -Scopes <String[]>
 [-Environment <EnvironmentName>]
 [-Tenant <String>]
 [-UseAuthorizationCode]
 [-UseDeviceAuthentication]
 [<CommonParameters>]

New-PartnerAccessToken
 -Module <ModuleName>
 [-Environment <EnvironmentName>]
 [-RefreshToken <String>]
 [-Tenant <String>]
 [-UseAuthorizationCode]
 [<CommonParameters>]

Acquires an access token from Azure Active Directory.

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

The first command gets the service principal credentials (application identifier and service principal secret), and then stores them in the $credential variable. The second command will request a new access token from Azure Active Directory. When using the UseAuthorizationCode parameter you will be prompted to authentication interactively using the authorization code flow. The redirect URI value will generated dynamically. This generation process will attempt to find a port between 8400 and 8999 that is not in use. Once an available port has been found, the redirect URL value will be constructed (e.g. http://localhost:8400). So, it is important that you have configured the redirect URI value for your Azure Active Directory application accordingly.

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'

The first command gets the service principal credentials (application identifier and service principal secret), and then stores them in the $credential variable. The third command will generate a new access token using the service principal credentials stored in the $credential variable and the refresh token stored in the $refreshToken variable for authentication.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.