Partilhar via

Pac Auth

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

Ligue-se ao seu inquilino

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 na sua máquina. 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 um diferente. Você pode usar o ID do ambiente, url, nome exclusivo ou nome parcial como o valor.

  • Em ambientes onde 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, no GitHub Codespaces, o --deviceCode parâmetro é adicionado automaticamente quando você executa pac auth createo .

Example

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

pac auth create --environment "HR-Dev"

Mudar para outro perfil de autenticação

Quando você tem vários perfis de autenticação, você pode alternar facilmente usando os comandos pac auth list e pac auth select .

O pac auth list comando lista todos os perfis de autenticação na sua máquina. 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 claro Limpar todos os perfis de autenticação armazenados neste computador
pac auth criar Criar e armazenar perfis de autenticação neste computador
pac auth excluir Excluir um perfil de autenticação específico
Lista de autenticação PAC Listar os perfis de autenticação armazenados neste computador
Nome da autenticação PAC Nomear ou renomear um perfil de autenticação existente
PAC Auth Selecione Selecione qual perfil de autenticação deve estar ativo
atualização pac auth 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 claro

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

pac auth criar

Criar e armazenar perfis de autenticação neste computador

Examples

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 no Codespaces, isso acionará um login de código de dispositivo.

Criação de ambiente

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

pac auth create --environment < Your environment ID >

Sugestão

Para encontrar uma ID de ambiente:

  1. Abra o Centro de administração da Power Platform e selecione o Ambiente ao qual pretende ligar. Na seção Detalhes , procure por ID do ambiente

Criado com nome

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

pac auth create --name MyOrg

Criado nomeado com a entidade de serviço

Este exemplo autentica com seu locatário, dá-lhe 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 auth create

--applicationId -id

Opcional: O ID do aplicativo com o qual autenticar.

--azureDevOpsFederated -adof

(Pré-visualização) Usar a Federação de DevOps do Azure para autenticação da entidade de serviço; requer argumentos --tenant e --applicationId

Este parâmetro não requer valor. É uma mudança.

--certificateDiskPath -cdp

Opcional: O caminho do disco do certificado para autenticar com

--certificatePassword -cp

Opcional: A senha do certificado para autenticação com

--clientSecret -cs

Opcional: O segredo do cliente para autenticar com

--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 de código de dispositivo do Microsoft Entra ID para entrada interativa.

Este parâmetro não requer valor. É uma mudança.

--environment -env

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

--githubFederated -ghf

(Pré-visualização) Use a Federação do GitHub para autenticação da entidade de serviço; requer argumentos --tenant e --applicationId

Este parâmetro não requer valor. É uma mudança.

--managedIdentity -mi

Use Azure Managed Identity.

Este parâmetro não requer valor. É uma mudança.

--name -n

O nome que pretende atribuir a este perfil de autenticação (máximo de 30 carateres).

Nota: O comprimento do nome deve estar entre 1 e 30

--password -p

Opcional: A senha para autenticar com

--tenant -t

ID do locatário se estiver usando ID do aplicativo/segredo do cliente ou 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 ID do Microsoft Entra se não for especificada.

Observações

Para o cloud parâmetro, os valores a serem usados são mapeados para essas outras siglas ou nomes comuns:

  • CCG = UsGov
  • CCG Alto = UsGovHigh
  • DoD = UsGovDod

Problemas de autenticação do WSL2

Ao usar o Windows Subsystem for 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á um navegador padrão definido em seu ambiente WSL2.

Para contornar esse problema, você pode usar a autenticação de código de dispositivo adicionando o --deviceCode sinalizador ao comando auth create : 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 excluir

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

Nota: O valor deve ser um inteiro com valor mínimo de 1.

--name -n

O nome do perfil a ser ativo

Nota: O comprimento do nome deve estar entre 1 e 30

Lista de autenticação PAC

Listar os perfis de autenticação armazenados neste computador

Nome da autenticação PAC

Nomear ou renomear um perfil de autenticação existente

Example

O exemplo a seguir mostra como renomear um perfil de autenticação. Nesse caso, o perfil com índice 1 será renomeado para '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

Nota: O valor deve ser um inteiro com valor mínimo de 1.

--name -n

O nome que pretende atribuir a este perfil de autenticação (máximo de 30 carateres).

Nota: O comprimento do nome deve estar entre 1 e 30

PAC Auth Selecione

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.

Nota: O valor deve ser um inteiro com valor mínimo de 1.

--name -n

O nome do perfil a ser ativo

Nota: O comprimento do nome deve estar entre 1 e 30

atualização pac auth

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

Examples

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

Atualizar perfil de autenticação com 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 perfil de autenticação com ID de 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

Nota: 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 pretende atribuir a este perfil de autenticação (máximo de 30 carateres).

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