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 ejecutapac 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 who | 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
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:
- 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
.
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.
--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: 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).
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
Visión general de Microsoft Power Platform CLI