Compartilhar via

pac auth

Gerenciar como você se autentica em vários serviços

Conectar-se ao seu locatário

Use o comando pac auth create para se conectar ao seu locatário. A execução pac auth create cria um perfil de autenticação em seu computador. Você pode ter vários perfis de autenticação disponíveis. Ter vários perfis de autenticação é interessante quando você trabalha com vários locatários. Por exemplo, quando sua empresa usa vários locatários (para desenvolvimento, produção e teste) ou quando você é um consultor que trabalha para vários clientes.

O pac auth create comando tem alguns parâmetros úteis:

  • O --environment parâmetro permite que você se conecte automaticamente ao ambiente certo. Se você omitir o --environment parâmetro, estará conectado ao ambiente padrão, mas com o --environment parâmetro adicionado a ele, poderá se conectar a outro. Você pode usar a ID do ambiente, a URL, o nome exclusivo ou o nome parcial como o valor.

  • Em ambientes em que você não tem a capacidade de usar uma experiência interativa, adicionar o --deviceCode parâmetro garante que você ainda possa se conectar. Por exemplo, nos Codespaces do GitHub, o --deviceCode parâmetro é adicionado automaticamente quando você executa pac auth create.

Example

Para se conectar ao HR-Dev ambiente, você pode usar o seguinte exemplo:

pac auth create --environment "HR-Dev"

Alternar para outro perfil de autenticação

Quando você tem vários perfis de autenticação, é possível alternar facilmente usando a lista de autenticação pac e os comandos pac auth select .

O pac auth list comando lista todos os perfis de autenticação em seu computador. O pac auth select comando seleciona um comando diferente.

pac auth list Exemplo

Para listar todos os perfis de autenticação, use o seguinte exemplo:

pac auth list

A execução do pac auth list comando retorna todos os perfis de autenticação:

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

Selecione um perfil de autenticação diferente usando o valor do índice.

pac auth select --index 2

Commands

Command Description
pac auth clear Limpar todos os perfis de autenticação armazenados neste computador
pac auth create Criar e armazenar perfis de autenticação neste computador
pac auth delete Excluir um perfil de autenticação específico
pac auth list Listar os perfis de autenticação armazenados neste computador
nome da autenticação pac Nomeie ou renomeie um perfil de autenticação existente
pac auth select Selecione qual perfil de autenticação deve estar ativo
pac auth update Atualizar o nome ou o ambiente de destino de um perfil de autenticação existente
pac auth quem Exibir informações sobre o perfil de autenticação selecionado no momento

pac auth clear

Limpar todos os perfis de autenticação armazenados neste computador

pac auth create

Criar e armazenar perfis de autenticação neste computador

Exemplos

Os exemplos a seguir mostram o uso do pac auth create comando.

Criação Básica

Este exemplo solicitará credenciais e se conectará ao locatário ao qual as credenciais pertencem.

pac auth create

Observação

Ao executar a CLI do Power Platform em Codespaces, isso disparará um logon de código do dispositivo.

Criação de ambiente

Este exemplo solicitará credenciais e se conectará ao ambiente do Power Platform com a ID do ambiente especificada.

pac auth create --environment < Your environment ID >

Dica

Para localizar uma ID de ambiente:

  1. Abra o Centro de administração do Power Platform e selecione o Ambiente ao qual você deseja se conectar. Na seção Detalhes , procure a ID do Ambiente

Criação nomeada

Este exemplo é autenticado com seu locatário e lhe dá o nome MyOrg.

pac auth create --name MyOrg

Criação nomeada com entidade de serviço

Este exemplo é autenticado com seu locatário, fornece o nome MyOrg-SPN e usa uma entidade de serviço para fazer isso. Não se esqueça de adicionar a entidade de serviço ao seu ambiente.

pac auth create --name MyOrg-SPN --applicationId 00000000-0000-0000-0000-000000000000 --clientSecret $clientSecret --tenant 00000000-0000-0000-0000-000000000000

Parâmetros opcionais para criação de autenticação

--applicationId -id

Opcional: a ID do aplicativo com a qual autenticar.

--azureDevOpsFederated -adof

(Versão prévia) Usar a Federação de DevOps do Azure para Autenticação da Entidade de Serviço; requer argumentos --tenant e --applicationId

Esse parâmetro não requer nenhum valor. É um comutador.

--certificateDiskPath -cdp

Opcional: o caminho do disco de certificado com o qual autenticar

--certificatePassword -cp

Opcional: a senha do certificado com a qual autenticar

--clientSecret -cs

Opcional: o segredo do cliente com o qual autenticar

--cloud -ci

Opcional: a instância de nuvem com a qual autenticar

Use um destes valores:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Use o fluxo do Código do Dispositivo da ID do Microsoft Entra para entrada interativa.

Esse parâmetro não requer nenhum valor. É um comutador.

--environment -env

Ambiente padrão (ID, URL, nome exclusivo ou nome parcial).

--githubFederated -ghf

(Versão prévia) Usar a Federação do GitHub para Autenticação da Entidade de Serviço; requer argumentos --tenant e --applicationId

Esse parâmetro não requer nenhum valor. É um comutador.

--managedIdentity -mi

Use a Identidade Gerenciada do Azure.

Esse parâmetro não requer nenhum valor. É um comutador.

--name -n

O nome que você deseja dar a esse perfil de autenticação (no máximo 30 caracteres).

Observação: o comprimento do nome deve estar entre 1 e 30

--password -p

Opcional: a senha com a qual autenticar

--tenant -t

ID do locatário se estiver usando a ID do aplicativo/segredo do cliente ou a ID do aplicativo/certificado do cliente.

--url -u

Preterido: use --environment em vez disso.

--username -un

Opcional: o nome de usuário com o qual autenticar; mostra uma caixa de diálogo da ID do Microsoft Entra se não for especificada.

Observações

Para o cloud parâmetro, os valores a serem usados mapeiam para esses outros nomes ou acrônimos comuns:

  • GCC = UsGov
  • GCC High = UsGovHigh
  • DoD = UsGovDod

Problemas de autenticação do WSL2

Ao usar o Subsistema do Windows para Linux versão 2 (WSL2), você pode ter problemas de autenticação, como Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools quando não há nenhum navegador padrão definido em seu ambiente WSL2.

Para contornar esse problema, você pode usar a autenticação de código do dispositivo adicionando o --deviceCode sinalizador ao seu auth create comando: pac auth create --environment {env-id} --deviceCode. Você precisará inserir um código em um navegador fora do WSL2 para concluir o processo de autenticação.

pac auth delete

Excluir um perfil de autenticação específico

Example

pac auth delete --index 2

Parâmetros opcionais para exclusão de autenticação

--index -i

O índice do perfil a ser excluído

Observação: o valor deve ser um inteiro com valor mínimo de 1.

--name -n

O nome do perfil a ser ativo

Observação: o comprimento do nome deve estar entre 1 e 30

pac auth list

Listar os perfis de autenticação armazenados neste computador

nome da autenticação pac

Nomeie ou renomeie um perfil de autenticação existente

Example

O exemplo a seguir mostra como renomear um perfil de autenticação. Nesse caso, o perfil com o índice 1 será renomeado como 'Contoso Dev'.

pac auth name --index 1 --name "Contoso Dev"

Parâmetros necessários para o nome da autenticação

--index -i

O índice do perfil a ser nomeado/renomeado

Observação: o valor deve ser um inteiro com valor mínimo de 1.

--name -n

O nome que você deseja dar a esse perfil de autenticação (no máximo 30 caracteres).

Observação: o comprimento do nome deve estar entre 1 e 30

pac auth select

Selecione qual perfil de autenticação deve estar ativo

Example

pac auth select --index 2

Parâmetros opcionais para seleção de autenticação

--index -i

O índice do perfil a ser ativo.

Observação: o valor deve ser um inteiro com valor mínimo de 1.

--name -n

O nome do perfil a ser ativo

Observação: o comprimento do nome deve estar entre 1 e 30

pac auth update

Atualizar o nome ou o ambiente de destino de um perfil de autenticação existente

Exemplos

Os exemplos a seguir mostram o uso do comando pac auth update.

Atualizar o perfil de autenticação com a URL do ambiente

Este exemplo mostra como atualizar o perfil de autenticação com o índice 1 com o nome Contoso Dev e a URL https://contosodev.crm.dynamics.comdo ambiente.

pac auth update --index 1 --name "Contoso Dev" --environment "https://contosodev.crm.dynamics.com"

Atualizar o perfil de autenticação com a ID do ambiente

Este exemplo mostra como atualizar o perfil de autenticação com o índice 1 com a ID 00000000-0000-0000-0000-000000000000do ambiente.

pac auth update --index 1 --environment 00000000-0000-0000-0000-000000000000

Parâmetros necessários para atualização de autenticação

--index -i

O índice do perfil a ser nomeado/renomeado

Observação: o valor deve ser um inteiro com valor mínimo de 1.

Parâmetros opcionais para atualização de autenticação

--environment -env

Ambiente padrão (ID, URL, nome exclusivo ou nome parcial).

--name -n

O nome que você deseja dar a esse perfil de autenticação (no máximo 30 caracteres).

pac auth quem

Exibir informações sobre o perfil de autenticação selecionado no momento

Consulte também

Grupos de comandos da CLI do Microsoft Power Platform
Visão geral da CLI do Microsoft Power Platform

  • Last updated on