Compartilhar via

New-PartnerAccessToken

Módulo:
PartnerCenter Module

Adquire um token de acesso do Azure Active Directory.

Sintaxe

AccessToken 

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

RefreshToken 

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

ServicePrincipal 

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

ServicePrincipalCertificate 

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

User 

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

ByModule 

New-PartnerAccessToken
    -Module <ModuleName>
    [-Environment <EnvironmentName>]
    [-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 para o Partner Center.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessToken
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ApplicationId

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ClientId

Conjuntos de parâmetros

AccessToken
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipal
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalCertificate
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
User
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CertificateThumbprint

Hash de certificado (impressão digital)

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RefreshToken
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Credential

Credenciais que representam a entidade de serviço.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessToken
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RefreshToken
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Environment

O ambiente usado para autenticação.

Propriedades do parâmetro

Tipo:EnvironmentName
Valor padrão:None
Valores aceitos:AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Dá suporte a curingas:False
DontShow:False
Aliases:EnvironmentName

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Module

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

Propriedades do parâmetro

Tipo:ModuleName
Valor padrão:None
Valores aceitos:ExchangeOnline
Dá suporte a curingas:False
DontShow:False
Aliases:NomeDoMódulo

Conjuntos de parâmetros

RefreshToken
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RefreshToken

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RefreshToken
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Scopes

Escopos solicitados para acessar uma API protegida.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessToken
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RefreshToken
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipal
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalCertificate
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
User
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServicePrincipal

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RefreshToken
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalCertificate
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Tenant

O identificador do locatário do Azure AD.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Domínio, ID do Inquilino (TenantId)

Conjuntos de parâmetros

AccessToken
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RefreshToken
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
User
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByModule
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseAuthorizationCode

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Código de autenticação

Conjuntos de parâmetros

ServicePrincipal
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalCertificate
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
User
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByModule
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseDeviceAuthentication

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:DeviceCode, DeviceAuth, Dispositivo

Conjuntos de parâmetros

User
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

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