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:

PowerShell

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:

PowerShell

pac auth list

Al ejecutar el comando pac auth list se devuelven todos los perfiles de autenticación:

PowerShell

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.

PowerShell

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.

• Creación básica
• ambiente Crear
• Nombrado Crear
• Creación con nombre y entidad principal del servicio

Crear básico

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

PowerShell

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.

PowerShell

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 el Entorno para ocultar la aplicación heredada. 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.

PowerShell

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.

PowerShell

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.

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

--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 :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: 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

PowerShell

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

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

PowerShell

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

PowerShell

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 ambiente
• Actualizar el perfil de autenticación con el ID ambiente

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.

PowerShell

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.

PowerShell

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

pac auth who

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