Compartir por


Autenticación de pac

Xestionar como se autentica en varios servizos

Conecta co teu inquilino

Use o comando pac auth create para conectarse ao inquilino. A execución pac auth create crea un perfil de autenticación na máquina. Pode ter varios perfís de autenticación dispoñibles. Ter varios perfís de autenticación é interesante cando traballas con varios inquilinos. Por exemplo, cando a túa empresa usa varios inquilinos (para desenvolvemento, produción e probas) ou cando es un consultor que traballa para varios clientes.

O pac auth create comando ten un par de parámetros útiles:

  • O --environment parámetro permítelle conectarse automaticamente ao ambiente adecuado. Se omites o --environment parámetro, estás conectado ao entorno predeterminado, pero co --environment parámetro engadido a el, podes conectarte a outro diferente. Pode usar o ID do ambiente, a url, o nome único ou o nome parcial como valor.

  • En ambientes onde non tes a capacidade de usar unha experiencia interactiva, engadir o --deviceCode parámetro asegura que aínda podes conectarte. Por exemplo, en GitHub Codespaces, o --deviceCode parámetro engádese automaticamente cando executas pac auth create.

Exemplo

Para conectarse ao HR-Dev entorno, podes usar o seguinte exemplo:

pac auth create --environment "HR-Dev"

Cambiar a outro perfil de autenticación

Cando tes varios perfís de autenticación, podes cambiar facilmente usando os comandos pac auth list e pac auth select.

O pac auth list comando lista todos os perfís de autenticación do equipo. O pac auth select comando selecciona un comando diferente.

pac auth list Exemplo

Para listar todos os perfís de autenticación, use o seguinte exemplo:

pac auth list

Ao executar o pac auth list comando devolve todos os perfís de autenticación:

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

Seleccione un perfil de autenticación diferente usando o valor do índice.

pac auth select --index 2

Comandos

Comando Descripción
pac auth clear Limpar todos os perfís de autenticación almacenados neste ordenador
pac auth create Crear e almacenar perfís de autenticación neste ordenador
pac auth borrar Eliminar un perfil de autenticación específico
Lista de autenticación de pac Listar os perfís de autenticación almacenados neste ordenador
Nome de autenticación de pac Nomear ou renomear un perfil de autenticación existente
Selección de autenticación pac Selecciona o perfil de autenticación que debe estar activo
Actualización de autenticación de PAC Actualizar o nome ou o entorno de destino dun perfil de autenticación existente
Pac Auth Who Mostrar información sobre o perfil de autenticación seleccionado actualmente

pac auth clear

Limpar todos os perfís de autenticación almacenados neste ordenador

pac auth create

Crear e almacenar perfís de autenticación neste ordenador

Exemplos

Os seguintes exemplos mostran o uso do pac auth create comando.

Creación básica

Este exemplo solicitaralle credenciais e conéctase ao inquilino ao que pertencen as credenciais.

pac auth create

Nota

Ao executar a CLI de Power Platform en Codespaces, isto desencadeará un inicio de sesión de código do dispositivo.

Creación de contorna

Este exemplo solicitaralle credenciais e conéctase ao entorno de Power Platform co ID de ambiente que especifique.

pac auth create --environment < Your environment ID >

Suxestión

Para atopar un ID de ambiente:

  1. Abra o centro de administración de Power Platform e seleccione o entorno ao que desexa conectarse. Na sección Detalles , busque o ID do ambiente

Crear con nome

Este exemplo autentica co seu inquilino e dálle o nome MyOrg.

pac auth create --name MyOrg

Creación con principal de servizo

Este exemplo autentica co seu inquilino, dálle o nome MyOrg-SPN e usa unha entidade de servizo para facelo. Non esquezas engadir o principal de servizo ao teu entorno.

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

Parámetros opcionais para a creación de autenticación

--applicationId -id

Opcional: O ID da aplicación coa que autenticarse.

--azureDevOpsFederated -adof

(Vista previa) Use Azure DevOps Federation for Service Principal Auth; require os argumentos --tenant e --applicationId

Este parámetro non precisa de valor. É un cambio.

--certificateDiskPath -cdp

Opcional: A ruta do disco do certificado coa que autenticarse

--certificatePassword -cp

Opcional: O contrasinal do certificado para autenticarse

--clientSecret -cs

Opcional: O segredo do cliente co que autenticarse

--cloud -ci

Opcional: A instancia na nube coa que autenticarse

Utiliza un destes valores:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Use o fluxo de código de dispositivo de Microsoft Entra ID para iniciar sesión interactivo.

Este parámetro non precisa de valor. É un cambio.

--environment -env

Contorna predeterminada (ID, url, nome único ou nome parcial).

--githubFederated -ghf

(Vista previa) Use a federación de GitHub para a autenticación do principal de servizo; require os argumentos --tenant e --applicationId

Este parámetro non precisa de valor. É un cambio.

--managedIdentity -mi

Utiliza a identidade xestionada de Azure.

Este parámetro non precisa de valor. É un cambio.

--name -n

O nome que desexa dar a este perfil de autenticación (máximo 30 caracteres).

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

--password -p

Opcional: O contrasinal para autenticarse

--tenant -t

Identificador de inquilino se usa ID de aplicación/segredo de cliente ou ID de aplicación/certificado de cliente.

--url -u

Obsoleto: Usa no --environment seu lugar.

--username -un

Opcional: O nome de usuario co que autenticarse; Mostra un diálogo de ID de Microsoft Entra se non se especifica.

Comentarios

Para o cloud parámetro, os valores a usar mapean a estes outros acrónimos ou nomes comúns:

  • GCC = UsGov
  • GCC Alto = UsGovHigh
  • DoD = UsGovDod

Problemas de autenticación WSL2

Ao usar o subsistema de Windows para Linux versión 2 (WSL2), pode ter problemas de autenticación, como Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools cando non hai un navegador predeterminado establecido no seu entorno WSL2.

Para solucionar este problema, pode usar a autenticación do código do dispositivo engadindo a --deviceCode bandeira ao comando auth create : pac auth create --environment {env-id} --deviceCode. Terás que introducir un código nun navegador fóra de WSL2 para completar o proceso de autenticación.

pac auth borrar

Eliminar un perfil de autenticación específico

Exemplo

pac auth delete --index 2

Parámetros opcionais para a eliminación da autenticación

--index -i

O índice do perfil a eliminar

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

--name -n

O nome do perfil a estar activo

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

Lista de autenticación de pac

Listar os perfís de autenticación almacenados neste ordenador

Nome de autenticación de pac

Nomear ou renomear un perfil de autenticación existente

Exemplo

No seguinte exemplo móstrase como cambiar o nome dun perfil de autenticación. Neste caso, o perfil co índice 1 será renomeado a "Contoso Dev".

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

Parámetros necesarios para o nome de autenticación

--index -i

Índice do perfil a nomear/renomear

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

--name -n

O nome que desexa dar a este perfil de autenticación (máximo 30 caracteres).

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

Selección de autenticación pac

Selecciona o perfil de autenticación que debe estar activo

Exemplo

pac auth select --index 2

Parámetros opcionais para a selección de autenticación

--index -i

O índice do perfil para estar activo.

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

--name -n

O nome do perfil a estar activo

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

Actualización de autenticación de PAC

Actualizar o nome ou o entorno de destino dun perfil de autenticación existente

Exemplos

Os seguintes exemplos mostran o uso do comando pac auth update.

Actualizar o perfil de autenticación coa URL do entorno

Este exemplo móstrase como actualizar o perfil de autenticación co índice 1 co nome Contoso Dev e o URL https://contosodev.crm.dynamics.comdo entorno.

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

Actualizar o perfil de autenticación co ID de ambiente

Este exemplo móstrase como actualizar o perfil de autenticación co índice 1 co ID 00000000-0000-0000-0000-000000000000de ambiente.

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

Parámetros necesarios para a actualización da autenticación

--index -i

Índice do perfil a nomear/renomear

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

Parámetros opcionais para a actualización de autenticación

--environment -env

Contorna predeterminada (ID, url, nome único ou nome parcial).

--name -n

O nome que desexa dar a este perfil de autenticación (máximo 30 caracteres).

Pac Auth Who

Mostrar información sobre o perfil de autenticación seleccionado actualmente

Consulte tamén

Grupos de comandos da CLI de Microsoft Power Platform
Visión xeral da CLI de Microsoft Power Platform