New-PartnerAccessToken

Referência

Módulo:: PartnerCenter

Adquire um token de acesso do Azure Active 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 Active 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 de aplicativo e segredo da entidade de serviço) e as armazena na variável $credential. O segundo comando solicitará um novo token de acesso do Azure Active Directory. Ao usar o parâmetro UseAuthorizationCode, você será solicitado a autenticar interativamente usando o fluxo de código de autorização. O valor do URI de redirecionamento será gerado dinamicamente. Esse processo de geração tentará encontrar uma porta entre 8400 e 8999 que não esteja em uso. Depois que uma porta disponível for encontrada, o valor da URL de redirecionamento será construído (por exemplo, http://localhost:8400). Portanto, é importante que você tenha configurado o valor do URI de redirecionamento para seu aplicativo do Azure Active Directory adequadamente.

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 de aplicativo e segredo da entidade de serviço) e as armazena 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 do Partner Center.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ApplicationId

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

Tipo:	String
Aliases:	ClientId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CertificateThumbprint

Hash de certificado (impressão digital)

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Credential

Credenciais que representam a entidade de serviço.

Tipo:	PSCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Environment

O uso do ambiente para autenticação.

Tipo:	EnvironmentName
Aliases:	EnvironmentName
Valores aceitos:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Module

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

Tipo:	ModuleName
Aliases:	ModuleName
Valores aceitos:	ExchangeOnline, ExchangeOnline
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RefreshToken

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Scopes

Escopos solicitados para acessar uma API protegida.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServicePrincipal

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Tenant

O identificador do locatário do Azure AD.

Tipo:	String
Aliases:	Domain, TenantId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UseAuthorizationCode

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

Tipo:	SwitchParameter
Aliases:	AuthCode
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UseDeviceAuthentication

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

Tipo:	SwitchParameter
Aliases:	DeviceCode, DeviceAuth, Device
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Saídas

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

Compartilhar via