New-PartnerAccessToken

Módulo:

PartnerCenter

Adquiere un token de acceso de Azure Active Directory.

Sintaxis

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

Adquiere un token de acceso de Azure Active Directory.

Ejemplos

Ejemplo 1: Generación de un nuevo token de acceso

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

El primer comando obtiene las credenciales de la entidad de servicio (identificador de aplicación y secreto de entidad de servicio) y, a continuación, las almacena en la variable $credential. El segundo comando solicitará un nuevo token de acceso desde Azure Active Directory. Al usar el parámetro UseAuthorizationCode, se le pedirá que autentificación interactivamente mediante el flujo de código de autorización. El valor del URI de redirección se generará dinámicamente. Este proceso de generación intentará encontrar un puerto entre 8400 y 8999 que no está en uso. Una vez encontrado un puerto disponible, se construirá el valor de la dirección URL de redireccionamiento (por ejemplo, http://localhost:8400). Por lo tanto, es importante que haya configurado el valor del URI de redirección para la aplicación de Azure Active Directory en consecuencia.

Ejemplo 2: Generación de un token de acceso mediante un token de actualización

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'

El primer comando obtiene las credenciales de la entidad de servicio (identificador de aplicación y secreto de entidad de servicio) y, a continuación, las almacena en la variable $credential. El tercer comando generará un nuevo token de acceso mediante las credenciales de la entidad de servicio almacenadas en la variable $credential y el token de actualización almacenado en la variable $refreshToken para la autenticación.

Parámetros

-AccessToken

Token de acceso del Centro de partners.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ApplicationId

Identificador de aplicación que se va a usar durante la autenticación.

Tipo:	String
Alias:	ClientId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CertificateThumbprint

Hash de certificado (huella digital)

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

Credenciales que representan la entidad de servicio.

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Environment

El entorno se usa para la autenticación.

Tipo:	EnvironmentName
Alias:	EnvironmentName
Valores aceptados:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Module

Módulo que se está generando un token de acceso.

Tipo:	ModuleName
Alias:	ModuleName
Valores aceptados:	ExchangeOnline, ExchangeOnline
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RefreshToken

Token de actualización que se va a usar durante la autenticación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Scopes

Ámbitos solicitados para acceder a una API protegida.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServicePrincipal

Indica que esta cuenta se autentica proporcionando credenciales de entidad de servicio.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Tenant

Identificador del inquilino de Azure AD.

Tipo:	String
Alias:	Domain, TenantId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseAuthorizationCode

Use el flujo de código de autorización durante la autenticación.

Tipo:	SwitchParameter
Alias:	AuthCode
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseDeviceAuthentication

Uso de la autenticación de código de dispositivo en lugar de un control de explorador

Tipo:	SwitchParameter
Alias:	DeviceCode, DeviceAuth, Device
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

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