New-PartnerAccessToken

Módulo:

PartnerCenter

Adquire um token de acesso do Azure Ative Directory.

Sintaxe

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

Adquire um token de acesso do Azure Ative Directory.

Exemplos

Exemplo 1: Gerando um novo token de acesso

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

O primeiro comando obtém as credenciais da entidade de serviço (identificador do aplicativo e segredo da entidade de serviço) e, em seguida, armazena-as na variável $credential. O segundo comando solicitará um novo token de acesso do Azure Ative Directory. Ao usar o parâmetro UseAuthorizationCode, você será solicitado a autenticar interativamente usando o fluxo de código de autorização. O valor de URI de redirecionamento será gerado dinamicamente. Este processo de geração tentará encontrar uma porta entre 8400 e 8999 que não esteja em uso. Uma vez encontrada uma porta disponível, o valor do URL de redirecionamento será construído (por exemplo, http://localhost:8400). Portanto, é importante que você tenha configurado o valor de URI de redirecionamento para seu aplicativo Azure Ative Directory de acordo.

Exemplo 2: Gerando um token de acesso usando um token de atualização

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'

O primeiro comando obtém as credenciais da entidade de serviço (identificador do aplicativo e segredo da entidade de serviço) e, em seguida, armazena-as na variável $credential. O terceiro comando gerará um novo token de acesso usando as credenciais da entidade de serviço armazenadas na variável $credential e o token de atualização armazenado na variável $refreshToken para autenticação.

Parâmetros

-AccessToken

O token de acesso para o Partner Center.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ApplicationId

O identificador do aplicativo a ser usado durante a autenticação.

Tipo:	String
Aliases:	ClientId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CertificateThumbprint

Hash do certificado (impressão digital)

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Credential

Credenciais que representam a entidade de serviço.

Tipo:	PSCredential
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Environment

O uso do ambiente para autenticação.

Tipo:	EnvironmentName
Aliases:	EnvironmentName
Valores aceites:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Module

O módulo que um token de acesso está sendo gerado.

Tipo:	ModuleName
Aliases:	ModuleName
Valores aceites:	ExchangeOnline, ExchangeOnline
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RefreshToken

O token de atualização a ser usado durante a autenticação.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Scopes

Escopos solicitados para acessar uma API protegida.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ServicePrincipal

Indica que essa conta é autenticada fornecendo credenciais da entidade de serviço.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Tenant

O identificador do locatário do Azure AD.

Tipo:	String
Aliases:	Domain, TenantId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UseAuthorizationCode

Use o fluxo de código de autorização durante a autenticação.

Tipo:	SwitchParameter
Aliases:	AuthCode
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UseDeviceAuthentication

Usar autenticação de código de dispositivo em vez de um controle de navegador

Tipo:	SwitchParameter
Aliases:	DeviceCode, DeviceAuth, Device
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

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