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
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
pac auth delete	Elimina un perfil de autenticación determinado
pac auth list	Enumera los perfiles de autenticación almacenados en este equipo
pac auth name	Asignar nombre o cambiar el nombre de un perfil de autenticación existente
pac auth select	Seleccione el perfil de autenticación que debe estar activo
pac auth update	Actualice el nombre o el entorno de destino de un perfil de autenticación existente

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
• Crear entorno
• Crear nombre del autor
• Crear nombre del autor con entidad de servicio

Crear básico

Este ejemplo le solicitará las credenciales y se conectará con el inquilino al que pertenecen las credenciales.

pac auth create

Nota

Al ejecutar Power Platform CLI en Codespaces, esto activará un inicio de sesión con código de dispositivo.

Crear entorno

Este ejemplo le solicitará las credenciales y se conectará al entorno Power Platform con la identificación del entorno que especifique.

pac auth create --environment < Your environment ID >

Propina

Para encontrar un id. de entorno:

1. Abra el centro de administración de Power Platform y seleccione un 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

Parámetros opcionales para auth create

--applicationId -id

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

--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).

--kind -k

Obsoleto: Este parámetro se ignora.

--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: el nombre debe tener entre 1 y 30 caracteres

--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: Use --environment en su lugar.

--username -un

Opcional: nombre de usuario con el que se autenticará; muestra el cuadro de diálogo de id. de Microsoft Entra 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

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: el nombre debe tener entre 1 y 30 caracteres

pac auth list

Enumera los perfiles de autenticación almacenados en este equipo

pac auth name

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: el nombre debe tener entre 1 y 30 caracteres

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: el nombre debe tener entre 1 y 30 caracteres

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
• Actualizar el perfil de autenticación con el id. del entorno

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).

Consulte también

Grupos de comandos de Microsoft Power Platform CLI
Visión general de Microsoft Power Platform CLI