¿Qué es Microsoft Power Apps CLI?

Nota

A partir de noviembre de 2020:

  • Common Data Service ha cambiado de nombre a Microsoft Dataverse. Más información
  • Se ha actualizado parte de la terminología en Microsoft Dataverse. Por ejemplo, entidad es ahora tabla y campo es ahora columna. Más información

Este artículo se actualizará pronto para reflejar la terminología más reciente.

Microsoft Power Apps CLI es una interfaz de línea de comandos sencilla y completa que permite a desarrolladores y creadores de aplicaciones crear componentes de código personalizado.

Los útiles de Power Apps CLI son el primer paso hacia un sistema de administración del ciclo de vida de la aplicación (ALM) completo donde los desarrolladores de la empresa y los ISV pueden crear, compilar, depurar y publicar sus extensiones y personalizaciones de forma rápida y eficiente.

Instalar Power Apps CLI

Para obtener Power Apps CLI, realice lo siguiente:

  1. Instale Npm(se incluye con Node.js) o Node.js (se incluye con npm). Recomendamos LTS (soporte a largo plazo) versión 10.15.3 o superior.

  2. Instale Paquete de desarrollador .NET Framework 4.6.2.

  3. Si aún no tiene Visual Studio 2017 o posterior, siga una de estas opciones a continuación:

  4. Instalar Power Apps CLI.

  5. Para aprovechar todas las últimas capacidades, actualice los útiles de Power Apps CLI a la última versión mediante este comando:

    pac install latest
    

Nota

Actualmente, Power Apps CLI se admite actualmente solo en Windows 10.

Comandos comunes

Esta tabla enumera algunos de los comandos comunes utilizados en la CLI:

Comando Descripción
admin Comandos para las características del ciclo de vida del entorno.
auth Comandos para autenticarse en Dataverse.
org Comandos para trabajar con el entorno de Dataverse.
package Comandos para trabajar con proyectos de solución de CDS.
pcf Comandos para trabajar con Power Apps component framework.
complemento Comando para crear un proyecto de complemento.
solución Comandos para trabajar con los proyectos de solución de Microsoft Dataverse.
telemetry Administra la configuración de telemetría.

Administrador

Comandos para trabajar con las características del ciclo de vida del entorno. Tiene los siguientes parámetros:

Parámetros

Nombre de la propiedad Descripción
lista Muestra todos los entornos del inquilino. Tiene los siguientes parámetros
- environment-id: muestra todos los entornos que contienen una cadena determinada en su id (alias: -id).
- url: muestra todos los entornos que contienen una cadena determinada en su url (alias -u).
- type: muestra todos los entornos del tipo dado (alias: -t).
- name: muestra todos los entornos que contienen una cadena determinada en su nombre (alias -n).
- organization-id: muestra todos los entornos que contienen una cadena determinada en su ID de organización (alias: -oi).
Crear Crear un entorno nuevo. Tiene los siguientes parámetros:
- name: establece el nombre del entorno (alias: -n).
- region: establece el nombre de la región del entorno. El valor predeterminado es unitedstates si no se especifica (alias -r).
- type: establece el tipo de entorno. Los valores disponibles son prueba, espacio aislado, producción, SubscriptionBasedTrial (alias: -t).
- currency: establece la moneda predeterminada utilizada en el entorno. El valor predeterminado es USD si no se especifica (alias -c).
- language: establece el idioma predeterminado del entorno. El valor predeterminado es inglés si no se especifica (alias -l).
- templates: establece las aplicaciones de Dynamics 365 que se deben implementar en el entorno. Pasa como valores separados por comas (alias: -t).
- domain: establece el nombre de dominio que forma parte de la URL del entorno. Si el nombre de dominio ya está en uso, se agregará un valor numérico al nombre de dominio. Por ejemplo, si contoso ya está en uso, la URL del entorno se convertirá en https://contoso0.crm.dynamics.com (alias -d).
- input-file: los argumentos se pueden pasar en un archivo de entrada .json en lugar de a través de la línea de comandos. Por ejemplo, {"name" : "contoso"}. Los argumentos pasados a través de la línea de comandos tendrán prioridad sobre los argumentos del archivo de entrada .json (alias: -if).
copia de seguridad Realiza la copia de seguridad de un entorno. Tiene los siguientes parámetros:
- url: URL del entorno del que se realizará la copia de seguridad. (alias: -u).
- label: establece la etiqueta de copia de seguridad proporcionada (alias: -l).
- environment-id: ID del entorno del que se realizará la copia de seguridad (alias: -id).
- notes: notas adicionales proporcionadas para la copia de seguridad (alias: -n).
eliminar Elimina un entorno. Tiene los siguientes parámetros:
- url: URL del entorno que se eliminará (alias: -u).
- environment-id: ID del entorno que se eliminará (alias: -id).
restablecer Restablece un entorno. Tiene los siguientes parámetros:
- url: URL del entorno que se restablecerá (alias: -u)
- name: establece el nombre del entorno (alias: -n).
- currency: establece la moneda predeterminada utilizada en el entorno. El valor predeterminado es USD si no se especifica (alias -c)
- purpose: establece la descripción que se usa para asociar el entorno a un objetivo específico (alias: -p)
- language: establece el idioma predeterminado del entorno. El valor predeterminado es inglés si no se especifica (alias -l).
- templates: establece las aplicaciones de Dynamics 365 que se deben implementar en el entorno. Pasa como valores separados por comas (alias: -t).
- domain: establece el nombre de dominio que forma parte de la URL del entorno. Si el nombre de dominio ya está en uso, se agregará un valor numérico al nombre de dominio. Por ejemplo, si contoso ya está en uso, la URL del entorno se convertirá en https://contoso0.crm.dynamics.com (alias -d).
- input-file: los argumentos se pueden pasar en un archivo de entrada .json en lugar de a través de la línea de comandos. Por ejemplo, {"name" : "contoso"}. Los argumentos pasados a través de la línea de comandos tendrán prioridad sobre los argumentos del archivo de entrada .json (alias: -if).
list-backups Muestra todas las copias de seguridad disponibles. entorno. Tiene los siguientes parámetros:
- url: URL del entorno para el que desea mostrar las copias de seguridad (alias: -u).
- environment-id: ID del entorno para el que desea mostrar las copias de seguridad (alias: -id).
Restaurar Restablece un entorno desde una copia de seguridad determinada. Tiene los siguientes parámetros:
- source-url: URL del entorno de origen desde el que se restablecerá (alias: -s).
- target-url: URL del entorno de destino al que se restablecerá (alias: -t).
- selected-backup: fecha y hora de la copia de seguridad con el formato mm/dd/yyyy hh:mm o el más reciente (alias: -sb).
- name: nombre opcional del entorno restaurado (alias: -n).
copia Copia un entorno de origen a un entorno de destino. Tiene los siguientes parámetros:
- source-url: URL del entorno de origen que se copiará (alias: -su).
- target-url: URL del entorno de destino al que se copiará (alias: -tu).
- source-environment-id: ID del entorno de origen que se copiará (alias: -si).
- target-environment-id: Id del entorno de destino al que se copiará (alias: -ti).
- name: nombre que se utilizará para el entorno de destino. (alias: -n).
- type: tipo de copia. Los valores disponibles son: None, MinimalCopy, Fullcopy (alias: -t).

Paquete

Comando para trabajar con paquetes de soluciones. Tiene los siguientes parámetros:

Parámetros

Nombre de la propiedad Descripción Ejemplo
init Inicializa un nuevo proyecto de paquete. Tiene el siguiente parámetro:
- outputdirectory: salida directamente donde se crea el paquete.
pac package init --outputdirectory c:\samplepackage
add-reference Establece la ruta de referencia a la carpeta del proyecto de la solución pasando el parámetro path. pac package add-reference --path c:\Users\Downloads\SampleSolution
mostrar Muestra el contenido de un paquete dll o un archivo zip con un paquete.
Tiene el siguiente parámetro:
- paquete: la ubicación de la ruta al paquete dll (biblioteca) o al archivo zip.
pac package show c:\samplepackage.dll
implementar Implementa la dll de paquete o un archivo zip con un paquete.
Tiene los siguientes parámetros:
- archivo de registro: ruta a la ubicación de un archivo de registro donde se redirigen los registros.
- logConsole: esta opción se utiliza si desea dirigir los registros a la consola.
- paquete: la ubicación de la ruta al paquete dll (biblioteca) o al archivo zip con un paquete.
Nota: puede usar ambos parámetros logFile y logConsole juntos o utilizar uno u otro parámetro.
pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

PCF

Comandos para trabajar con Power Apps component framework. Tiene los siguientes parámetros:

Parámetros

Nombre de la propiedad Descripción Ejemplo
init Inicia el código del proyecto de componente. Tiene los siguientes parámetros
- namespace: espacio de nombres del componente de código.
- name: nombre del componente de código.
- template : campo o conjunto de datos
pac pcf init --namespace SampleNameSpace --name SampleComponent --template field
push Inserta el componente de código en la instancia de Dataverse con los últimos cambios. Tiene el siguiente parámetro:
- publisher-prefix: prefijo del anunciante de la organización.
pac pcf push --publisher-prefix dev
versión Actualiza el archivo de manifiesto del componente con la versión de parche especificada. Tiene los siguientes parámetros:
- patchversion: versión de parche del componente de código. patchversion solo tomará valor de la tercera parte de la tupla de versión: Major.Minor.Patch.
- path: ruta absoluta o relativa del archivo de manifiesto del componente.
- allmanifests: actualiza la versión del parche para todos los archivos de manifiesto del componente.
- updatetarget: actualiza el archivo de manifiesto especificado. Tiene dos valores, construir y proyectar.
- strategy: actualiza la versión del parche para los archivos de manifiesto utilizando valores de estrategia especificados. Tiene los siguientes valores:
- gittags: use las etiquetas git para decidir si la versión de parche de un componente en particular necesita actualizarse.
filetracking: use el archivo .csv para decidir si la versión de parche de un componente en particular necesita actualizarse.
- manifest : incrementa la versión del parche en 1 para todos los componentes.
pac pcf version --patchversion 1.0.0.0 --path c:\Users\Downloads\SampleComponent --allmanifests

pac pcf version --strategy gittags

Solución

Comandos para trabajar con los proyectos de solución de Dataverse. Tiene los siguientes parámetros:

Parámetros

Nombre de la propiedad Descripción Ejemplo
init Inicializa el proyecto de solución. Tiene los siguientes parámetros:
- publisher-name: nombre del anunciante de la organización.
- publisher-prefix: prefijo del anunciante de la organización.
pac solution init --publisher-name developer --publisher-prefix dev
add-reference Establece la ruta de referencia a la carpeta del proyecto componente pasando el parámetro path. pac solution add-reference --path c:\Users\Downloads\SampleComponent
clone Crea un proyecto de solución basado en un proyecto de solución existente. Tiene los siguientes parámetros:
-name: nombre de la solución que se exportará.
-targetversion: versión que admite la solución exportada.
-include: configuración que debe incluirse en la solución que se va a exportar.
Tiene los siguientes valores: autonumbering, calendar, customization, emailtracking, externalapplications, general, isvconfig, marketing, outlooksynchronization, relationshiproles, sales
pac solution clone -–name sampleSolution --version 1.0.0.2 --include general
importar Importa una solución Dataverse a un entorno. Requiere que esté conectado a los comandos de autenticación de un entorno y tiene los siguientes parámetros:
-activate-plugins: activa complementos y flujos de trabajo en el entorno después de la importación (alias: -ap).
-async: importa la solución de forma asincrónica (alias: -a).
-force-overwrite: fuerza la sobrescritura de personalizaciones no administradas (alias: -f).
-import-as-holding: importa la solución como solución de retención (alias: -h).
-max-async-wait-time: tiempo máximo de espera asincrónico en minutos. El valor predeterminado es 60 minutos (alias: -wt).
-path: ruta al archivo zip de la solución. Si no se especifica, presupone que es la carpeta actual (alias: -p).
-publish-changes: publica los cambios si la importación se realiza correctamente (alias: -pc).
-skip-dependency-check: omite la comprobación de dependencias respecto a las dependencias marcadas como actualización del producto (alias: -s).
pac solution import --path c:\Users\Documents\Solution.zip
export Exporta una solución Dataverse desde un entorno. Requiere que esté conectado a los comandos de autenticación de un entorno y tiene los siguientes parámetros:
-path: nombre completo del archivo donde se guardará el archivo zip de la solución exportada.
- name: nombre de la solución que se debe exportar.
- managed: define si la solución debe exportarse como una solución administrada o no.
-targetversion: versión que admite la solución exportada.
-include: configuración que debe incluirse en la solución que se va a exportar.
pac solution export --path c:\Users\Documents\Solution.zip -- name SampleComponentSolution --managed true --targetversion 10.0.03 --include general
lista Enumere todas las soluciones en un entorno de Dataverse. Requiere que esté conectado a comandos de autenticación de un entorno. Este comando no tiene parámetros: pac solution list

Auth

Comandos para autenticarse en Dataverse. Tiene los siguientes parámetros:

Parámetros

Nombre de parámetro Descripción Ejemplo
Crear Crea el perfil de autenticación para su organización pasando el parámetro url. Pase la URL de la organización para el parámetro url. pac auth create --url https://Myorg.crm.dynamics.com
lista Proporciona la lista de perfiles de autenticación. pac auth list
Seleccionar Proporciona una manera de cambiar entre los perfiles de autenticación creados previamente pasando el parámetro index. pac auth select --index 2
eliminar Elimina el perfil de autenticación creado pasando el parámetro index. pac auth delete --index 2
clear Borra todo el perfil de autenticación creado en la máquina local. pac auth clear

Telemetría

Administra la configuración de telemetría. Tiene los siguientes parámetros:

Parámetros

Nombre de parámetro Descripción Ejemplo
enable Habilita la opción de telemetría. pac telemetry enable
disable Deshabilita la opción de telemetría. pac telemetry disable
estado Devuelve si la telemetría está habilitada o deshabilitada. pac telemetry status

Org

Comando para trabajar con organizaciones de Dataverse.

Parámetros

Nombre de parámetro Descripción Ejemplo
who Muestra información sobre las organizaciones actuales de Dataverse. pac org who

Plugin

Gestiona para crear un proyecto de complemento.

Parámetros

Nombre de parámetro Descripción Ejemplo
init Inicializa un directorio con una nueva biblioteca de clases. pac plugin init

Desinstalar Power Apps CLI

Para desinstalar los útiles Power Apps CLI, ejecute MSI desde aquí.

Si usted es participante de una Versión preliminar privada y tiene una versión anterior de CLI, siga estos pasos:

  1. Para averiguar dónde está instalado Power Apps CLI, abra un símbolo del sistema y escriba where pac.

  2. Elimine la carpeta de PowerAppsCLI.

  3. Abra la herramienta de variables de entorno ejecutando el comando rundll32 sysdm.cpl,EditEnvironmentVariables en el símbolo del sistema.

  4. Haga doble clic en Path en la sección User variable for....

  5. Seleccione la fila que contiene la ruta de PowerAppsCLI y seleccione el botón Eliminar en el lado derecho.

  6. Seleccione Aceptar dos veces.

Vea también

Power Apps component framework