Compartir a través de

pac auth

Administre cómo se autentica en diferentes servicios

Conéctese a su inquilino

Utilice el comando pac auth create para conectarse a su inquilino. Al ejecutar pac auth create se crea un perfil de autenticación en su máquina. Puede tener varios perfiles de autenticación disponibles. Tener varios perfiles de autenticación es interesante cuando se trabaja con varios inquilinos. Por ejemplo, cuando su empresa utiliza varios inquilinos (para desarrollo, producción y pruebas) o cuando es un consultor que trabaja para varios clientes.

El comando pac auth create tiene un par de parámetros útiles:

  • El parámetro --environment le permite conectarse automáticamente al entorno correcto. Si omite el parámetro --environment, está conectado al entorno predeterminado, pero con el parámetro --environment agregado, puede conectarse a uno diferente. Puede utilizar el ID del entorno, la URL, el nombre único o el nombre parcial como valor.

  • En entornos donde no tiene la capacidad de usar un experiencia interactiva, agregar el parámetro --deviceCode asegura que aún pueda conectarse. Por ejemplo, en GitHub Codespaces, el parámetro --deviceCode se agrega automáticamente cuando ejecuta pac auth create.

Ejemplo

Para conectarse al entorno HR-Dev, puede utilizar el siguiente ejemplo:

pac auth create --environment "HR-Dev"

Cambiar a otro perfil de autenticación

Cuando tiene varios perfiles de autenticación, puede cambiar fácilmente usando los comandos pac auth list y pac auth select.

El comando pac auth list enumera todos los perfiles de autenticación en su máquina. El comando pac auth select selecciona un comando diferente.

pac auth list Ejemplo

Para enumerar todos los perfiles de autenticación, use el ejemplo siguiente:

pac auth list

Al ejecutar el comando pac auth list se devuelven todos los perfiles 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 utilizando el valor del índice.

pac auth select --index 2

Comandos

Comando Descripción
autorización de pac clara Borra todos los perfiles de autenticación almacenados en este equipo
pac auth crear Crea y almacena perfiles de autenticación en este equipo
Eliminar autenticación de pac Elimina un perfil de autenticación determinado
lista de autenticación de pac Enumera los perfiles de autenticación almacenados en este equipo
nombre de autenticación de pac Asignar nombre o cambiar el nombre de un perfil de autenticación existente
autenticación pac Seleccionar Seleccione el perfil de autenticación que debe estar activo
actualización de autenticación pac Actualice el nombre o el entorno de destino de un perfil de autenticación existente
pac auth quién Mostrar información sobre el perfil de autenticación seleccionado actualmente

pac auth clear

Borra todos los perfiles de autenticación almacenados en este equipo

pac auth create

Crea y almacena perfiles de autenticación en este equipo

Ejemplos

Los siguientes ejemplos muestran el uso del comando pac auth create.

Crear básico

En este ejemplo se le pide credenciales y se conecta al inquilino al que pertenecen las credenciales.

pac auth create

Nota

Al ejecutar la CLI de Power Platform en Codespaces, esta operación desencadena un inicio de sesión de código de dispositivo.

Crear entorno

En este ejemplo se le solicitan credenciales y se conecta al entorno de Power Platform con el identificador de entorno que especifique.

pac auth create --environment < Your environment ID >

Propina

Para buscar un identificador de entorno: abra el Centro de administración de Power Platform y seleccione el entorno al que desea conectarse. En la sección Detalles, busque el ID de entorno

Crear nombre del autor

Este ejemplo se autentica con su inquilino y le da el nombre MyOrg.

pac auth create --name MyOrg

Crear nombre del autor con entidad de servicio

Este ejemplo se autentica con su inquilino, le da el nombre MyOrg-SPN y utiliza una entidad de servicio para hacerlo. No olvide agregar la entidad de servicio en su entorno.

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

Identidad de Azure

Al ejecutarse en un entorno que admita Identidad de Azure (como Azure Cloud Shell, máquina virtual de Azure con identidad administrada o Visual Studio Code con la extensión de cuenta de Azure), puede usar la --managedIdentity marca para autenticarse mediante la identidad de Azure. La CLI de PAC usa la credencial predeterminada de Azure , que es una cadena preconfigurada y con opiniones de credenciales.

Las credenciales de Azure predeterminadas están diseñadas para admitir muchos entornos, junto con los flujos de autenticación y las herramientas de desarrollo más comunes. Puede personalizar el comportamiento estableciendo variables de entorno como se describe en la documentación de credenciales de Azure predeterminadas. Por ejemplo, para autenticarse mediante una identidad administrada asignada por el usuario, establezca la AZURE_CLIENT_ID variable de entorno en el identificador de cliente de la identidad administrada asignada por el usuario. Consulte más detalles en Establecer las variables de entorno de la aplicación.

Parámetros opcionales para auth create

--applicationId -id

Opcional: el id. de aplicación con el que se va a autenticar.

--azureDevOpsFederated -adof

(Versión preliminar) Utilice Azure DevOps Federation para autenticación de entidad de servicio; requiere los argumentos --tenant y --applicationId

Este parámetro no requiere ningún valor. Es un modificador.

--certificateDiskPath -cdp

Opcional: la ruta de acceso al disco del certificado con la que se va a autenticar

--certificatePassword -cp

Opcional: la contraseña del certificado con la que se va a autenticar

--clientSecret -cs

Opcional: secreto de cliente con el que se va a autenticar

--cloud -ci

Opcional: instancia en la nube con la que se va a autenticar

Utilice uno de estos valores:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Utilice el flujo de código de dispositivo de id. de Microsoft Entra para el inicio de sesión interactivo.

Este parámetro no requiere ningún valor. Es un modificador.

--environment -env

Entorno predeterminado (id., url, nombre único o nombre parcial).

--githubFederated -ghf

(Versión preliminar) Utilice la federación de GitHub para autenticación de entidad de servicio; requiere los argumentos --tenant y --applicationId

Este parámetro no requiere ningún valor. Es un modificador.

--managedIdentity -mi

Utilizar una identidad administrada de Azure

Este parámetro no requiere ningún valor. Es un modificador.

--name -n

Nombre que desea asignar a este perfil de autenticación (máximo de 30 caracteres).

Nota :La longitud del nombre debe estar entre 1 y 30

--password -p

Opcional: la contraseña para autenticar con

--tenant -t

Id. de inquilino si se utiliza el id. de aplicación/secreto de cliente o el id. de aplicación/certificado de cliente.

--url -u

Obsoleto : Usar --environment en cambio.

--username -un

Opcional: el nombre de usuario con el que se va a autenticar; muestra un cuadro de diálogo id. de Entra de Microsoft si no se especifica.

Comentarios

Para el parámetro cloud, los valores a utilizar corresponden a estos otros acrónimos o nombres comunes:

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

Problemas de autenticación de WSL2

Al usar el Subsistema de Windows para Linux versión 2 (WSL2), es posible que tenga problemas de autenticación, como Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools cuando no haya ningún explorador predeterminado establecido en el entorno de WSL2.

Para solucionar este problema, puede usar la autenticación de código de dispositivo agregando la --deviceCode marca al auth create comando : pac auth create --environment {env-id} --deviceCode. Tendrá que escribir un código en un explorador fuera de WSL2 para completar el proceso de autenticación.

pac auth delete

Elimina un perfil de autenticación determinado

Ejemplo

pac auth delete --index 2

Parámetros opcionales para auth delete

--index -i

Índice del perfil que se va a eliminar

Nota :El valor debe ser un número entero con un valor mínimo de 1.

--name -n

Nombre del perfil que se va a activar

Nota :La longitud del nombre debe estar entre 1 y 30

Lista de autenticación de pac

Enumera los perfiles de autenticación almacenados en este equipo

nombre de autenticación de pac

Asignar nombre o cambiar el nombre de un perfil de autenticación existente

Ejemplo

El siguiente ejemplo muestra cómo cambiar el nombre de un perfil de autenticación. En este caso, se cambiará el nombre del perfil con el índice 1 a "Contoso Dev".

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

Parámetros requeridos para auth name

--index -i

Índice del perfil al que se va a asignar nombre o cuyo nombre se va a cambiar

Nota :El valor debe ser un número entero con un valor mínimo de 1.

--name -n

Nombre que desea asignar a este perfil de autenticación (máximo de 30 caracteres).

Nota :La longitud del nombre debe estar entre 1 y 30

pac auth select

Seleccione el perfil de autenticación que debe estar activo

Ejemplo

pac auth select --index 2

Parámetros opcionales para auth select

--index -i

Índice del perfil que se va a activar.

Nota :El valor debe ser un número entero con un valor mínimo de 1.

--name -n

Nombre del perfil que se va a activar

Nota :La longitud del nombre debe estar entre 1 y 30

pac auth update

Actualice el nombre o el entorno de destino de un perfil de autenticación existente

Ejemplos

En los ejemplos siguientes se muestra el uso del comando pac auth update.

Actualizar el perfil de autenticación con la URL del entorno

Este ejemplo muestra cómo actualizar el perfil de autenticación con el índice 1 con el nombre Contoso Dev y la URL del entorno https://contosodev.crm.dynamics.com.

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

Actualizar el perfil de autenticación con el id. del entorno

Este ejemplo muestra cómo actualizar el perfil de autenticación con el índice 1 con el id. del entorno 00000000-0000-0000-0000-000000000000.

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

Parámetros requeridos para auth update

--index -i

Índice del perfil al que se va a asignar nombre o cuyo nombre se va a cambiar

Nota :El valor debe ser un número entero con un valor mínimo de 1.

Parámetros opcionales para auth update

--environment -env

Entorno predeterminado (id., url, nombre único o nombre parcial).

--name -n

Nombre que desea asignar a este perfil de autenticación (máximo de 30 caracteres).

autenticación pac quién

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

Consulte también

Grupos de comandos de Microsoft Power Platform CLI
Microsoft Power PlatformVisión general del CLI

  • Last updated on