Referencia de comandos de la CLI del entorno de ejecución administrado de Copilot

En este artículo se describen todos los comandos de la CLI del entorno de ejecución administrado de Copilot, con sintaxis y parámetros, para ayudarle a crear, implementar y compartir aplicaciones desde la línea de comandos. La CLI del entorno de ejecución administrado de Copilot se publica y @microsoft/cmr-cli se invoca como ms.

La mayoría de los comandos operan en la aplicación en el directorio actual y leen los valores predeterminados de su configuración local (nombre de la aplicación, entorno, enlace del repositorio). Ejecuta comandos desde el directorio que contiene la aplicación, a menos que una marca te permita dirigirte explícitamente a otra aplicación.

Esta referencia agrupa cada comando por tareas típicas de flujo de trabajo de desarrollador:

Group Comando Descripción
Autenticación ms auth login Inicie sesión en Microsoft Entra ID a través del explorador.
Autenticación ms auth logout Borre las credenciales almacenadas en caché y quite el puntero de la cuenta activa.
Autenticación ms auth status Enumere las cuentas almacenadas en caché e indique la activa.
Autenticación ms auth switch Active una cuenta en caché diferente.
Autenticación ms git auth refresh Actualice o establezca la asignación de identidad de Entra-to-GitHub.
Crear una aplicación ms app create Crear una nueva aplicación y andamiar una plantilla de proyecto.
Crear una aplicación ms app clone Clonar el repositorio de Git administrado por la plataforma de una aplicación existente.
Crear una aplicación ms app init Registrar un proyecto web existente como una aplicación.
Detectar conectores ms connector list Enumerar los conectores disponibles en un entorno.
Detectar conectores ms connector list-actions Enumerar las operaciones expuestas por un conector.
Administrar recursos de la aplicación ms app add backend Agregue un back-end de base de datos de Fabric a la aplicación.
Administrar recursos de la aplicación ms app add data-source Agregue un conector a la aplicación como una tabla o un origen de datos de acción.
Administrar recursos de la aplicación ms app remove data-source Quite un origen de datos agregado previamente (tabla o acción) de la aplicación.
Administrar recursos de la aplicación ms app refresh data-source Recupere el esquema y regenere TypeScript para los orígenes de datos enlazados.
Desarrollo local ms app dev Iniciar el ciclo completo de desarrollo local.
Compilar e implementar ms app pack Cree la aplicación localmente y prepare la salida para su inspección.
Compilar e implementar ms app build Desencadenar una compilación de plataforma para una confirmación específica.
Compilar e implementar ms app build-status Comprobar el estado de una compilación.
Compilar e implementar ms app deploy Promueva una compilación ecológica en la aplicación activa.
Play ms app play Abra una aplicación e imprima su URL de inicio.
Compartir ms app share Conceder acceso a usuarios o grupos.
Compartir ms app share list Enumerar los usuarios y grupos con los que se comparte una aplicación.
Compartir ms app unshare Revocar el acceso concedido anteriormente.
Compartir ms app share link create Cree un vínculo para compartir en todo el inquilino para la aplicación.
Compartir ms app share link list Enumerar los vínculos de recurso compartido emitidos para la aplicación.
Compartir ms app share link revoke Revocar un vínculo para compartir por id.
Inspección y administración ms app list Enumera las aplicaciones del entorno a las que puedes acceder.
Inspección y administración ms app info Mostrar el estado de la aplicación del lado servidor.
Inspección y administración ms app get-settings Mostrar todas las configuraciones de la aplicación y sus valores actuales.
Inspección y administración ms app set-setting Actualizar una o varias opciones de configuración de la aplicación.
Inspección y administración ms app delete Elimine la aplicación del entorno.
Administración ms admin add owner Agregue uno o varios propietarios de aplicaciones.
Administración ms admin remove owner Quitar uno o varios propietarios de aplicaciones.
de logística ms telemetry enable Activa la recopilación de telemetría.
de logística ms telemetry disable Desactiva la recopilación de telemetría.
de logística ms telemetry status Mostrar la configuración de telemetría actual.

Índice de comandos

En la tabla siguiente se enumeran los comandos alfabéticamente:

Get-Help Group Descripción
ms admin add owner Administración Agregue uno o varios propietarios de aplicaciones.
ms admin remove owner Administración Quitar uno o varios propietarios de aplicaciones.
ms app add backend Administrar recursos de la aplicación Agregue un back-end de base de datos de Fabric a la aplicación.
ms app add data-source Administrar recursos de la aplicación Agregue un conector a la aplicación como una tabla o un origen de datos de acción.
ms app build Compilar e implementar Desencadenar una compilación de plataforma para una confirmación específica.
ms app build-status Compilar e implementar Comprobar el estado de una compilación.
ms app clone Crear una aplicación Clonar el repositorio de Git administrado por la plataforma de una aplicación existente.
ms app create Crear una aplicación Crear una nueva aplicación y andamiar una plantilla de proyecto.
ms app delete Inspección y administración Elimine la aplicación del entorno.
ms app deploy Compilar e implementar Promueva una compilación ecológica en la aplicación activa.
ms app dev Desarrollo local Iniciar el ciclo completo de desarrollo local.
ms app get-settings Inspección y administración Mostrar todas las configuraciones de la aplicación y sus valores actuales.
ms app info Inspección y administración Mostrar el estado de la aplicación del lado servidor.
ms app init Crear una aplicación Registrar un proyecto web existente como una aplicación.
ms app list Inspección y administración Enumera las aplicaciones del entorno a las que puedes acceder.
ms app pack Compilar e implementar Cree la aplicación localmente y prepare la salida para su inspección.
ms app play Play Abra una aplicación e imprima su URL de inicio.
ms app refresh data-source Administrar recursos de la aplicación Recupere el esquema y regenere TypeScript para los orígenes de datos enlazados.
ms app remove data-source Administrar recursos de la aplicación Quite un origen de datos agregado previamente (tabla o acción) de la aplicación.
ms app set-setting Inspección y administración Actualizar una o varias opciones de configuración de la aplicación.
ms app share Compartir Conceder acceso a usuarios o grupos.
ms app share list Compartir Enumerar los usuarios y grupos con los que se comparte una aplicación.
ms app share link create Compartir Cree un vínculo para compartir en todo el inquilino para la aplicación.
ms app share link list Compartir Enumerar los vínculos de recurso compartido emitidos para la aplicación.
ms app share link revoke Compartir Revocar un vínculo para compartir por id.
ms app unshare Compartir Revocar el acceso concedido anteriormente.
ms auth login Autenticación Inicie sesión en Microsoft Entra ID a través del explorador.
ms auth logout Autenticación Borre las credenciales almacenadas en caché y quite el puntero de la cuenta activa.
ms auth status Autenticación Enumere las cuentas almacenadas en caché e indique la activa.
ms auth switch Autenticación Active una cuenta en caché diferente.
ms connector list Detectar conectores Enumerar los conectores disponibles en un entorno.
ms connector list-actions Detectar conectores Enumerar las operaciones expuestas por un conector.
ms git auth refresh Autenticación Actualice o establezca la asignación de identidad de Entra-to-GitHub.
ms telemetry disable de logística Desactiva la recopilación de telemetría.
ms telemetry enable de logística Activa la recopilación de telemetría.
ms telemetry status de logística Mostrar la configuración de telemetría actual.

Marcas globales

Cada comando acepta las siguientes marcas.

Flag Alias ¿Necesario? Descripción
--json No Genere el resultado como un único objeto JSON (o NDJSON para comandos de streaming). Use esta marca en scripts y CI.
--non-interactive No Ejecutar sin indicaciones. Suministre todos los valores necesarios mediante indicadores o variables de entorno. Use esta marca en scripts y CI.
--no-color No Deshabilitar salida coloreada.
--cloud <cloud> No Entorno de nube al que se va a dirigir. Los valores válidos son public (predeterminado), usgov, usgovhigh, usgovdody china.
--version -v No Imprima la versión de la CLI.
--help -h No Mostrar ayuda para el comando, incluidas todas las marcas disponibles.

Sugerencia

Ejecutar ms sin argumentos para la ayuda de nivel superior agrupada, ms app para los subcomandos de la aplicación y ms app <verb> --help para las marcas de un verbo. Las capacidades salen a la superficie progresivamente a medida que se profundiza.

Autenticación

Inicie sesión una vez por equipo. Todos los demás comandos asumen una sesión autenticada en un inquilino habilitado para el tiempo de ejecución administrado de Copilot.

ms auth login

Inicie sesión en Microsoft Entra ID a través del explorador. Agrega la nueva cuenta a la memoria caché y la activa.

ms auth login [--account <email>]

ms auth login account parámetro

Intenta iniciar su sesión como la cuenta seleccionada, lo que resulta útil para escenarios de varias cuentas. Para elegir entre las cuentas que ya están almacenadas en caché, use ms auth switch su lugar.


ms auth logout

Borre todas las credenciales almacenadas en caché y quite el puntero de la cuenta activa.

ms auth logout

Para cambiar la cuenta que está activa sin cerrar sesión, use ms auth switch.


ms auth status

Enumerar las cuentas almacenadas en caché. Cuando se almacena en caché más de una cuenta, la cuenta activa (la que usan otros comandos) se marca con *.

ms auth status

ms auth switch

Active una cuenta en caché diferente para los comandos posteriores.

ms auth switch [--account <email>]

ms auth switch account parámetro

La cuenta que se va a activar. En el modo interactivo con varias cuentas almacenadas en caché, la CLI solicita una selección si se omite esta marca. Requerido en el modo no interactivo y al usar --json.

Autenticación Git

Algunos comandos necesitan comprobar que su identidad de Microsoft Entra está asignada a un usuario de GitHub con acceso al repositorio enlazado. La primera vez que se necesita una asignación, ms app create, ms app buildy ms app deploy ejecute el flujo de código del dispositivo de GitHub en línea: no es necesario actualizar de forma proactiva para la configuración por primera vez. Se usa ms git auth refresh para volver a autenticar explícitamente (por ejemplo, al cambiar de cuenta de GitHub).

ms git auth refresh

Actualice o establezca la asignación de identidad de GitHub de Microsoft Entra ↔ para un repositorio propiedad de una organización de GitHub Enterprise Cloud.

ms git auth refresh --repo <url> [--open-browser]

El comando imprime la dirección URL de verificación y un código de usuario para que lo pegue en un explorador. Si se realiza correctamente, imprime el inicio de sesión de GitHub autenticado y la marca de tiempo de expiración de la asignación. Presione Ctrl+C para cancelar el bucle de sondeo limpiamente.

ms git auth refresh parámetros

Parámetro Alias ¿Necesario? Descripción
--repo -r Sí Una dirección URL completa de un repositorio propiedad de una organización de GitHub Enterprise Cloud. Por ejemplo, https://contoso.ghe.com/contoso/my-app o https://github.com/contoso/my-app. La CLI realiza solo una comprobación mínima de que la dirección URL tiene un host (que se usa para derivar el punto de conexión de inicio de sesión) y no aplica las reglas de host o esquema por sí misma. La plataforma es la autoridad sobre la que se admiten hosts y proveedores. La CLI le preguntará en modo interactivo si no establece este valor.
--open-browser No Mejor esfuerzo iniciar el explorador del sistema además de imprimir la dirección URL de comprobación. El valor predeterminado es de solo impresión.

Crear una aplicación

Usa estos comandos para crear una nueva aplicación de tiempo de ejecución de Copilot o registrar un proyecto existente.

Configura la visibilidad de repositorios y otras políticas de administración de repositorios en GitHub Enterprise Cloud. Para obtener más información, consulte Aplicación de directivas de administración de repositorios en la empresa.

ms app create

Cree una nueva aplicación, aplique scaffolding a una plantilla de proyecto en el directorio y configure el control de código fuente.

ms app create --display-name <name> [directory] [options]

ms app create parámetros

Parámetro Alias ¿Necesario? Description
--display-name <name> -n Sí Nombre para mostrar de la aplicación.
[directory] No Directorio de destino. Debe estar vacío. Cuando se omite, la CLI crea un directorio con el nombre para mostrar de la aplicación. Pass . explícitamente para utilizar el directorio actual.
--environment-id <id> -e No Entorno de destino. Cuando se omite, la CLI utiliza el entorno de desarrollo y aprovisiona uno en la primera ejecución.
--description <text> -d No Descripción de texto libre almacenada en el registro de la aplicación.
--template <name> -t No el repositorio de GitHub o la subruta de acceso desde la que aplicar scaffolding a la aplicación (por ejemplo, github:owner/repo/subdir). El valor predeterminado es la plantilla Vite integrada. Se aplica a todos los --repo modos.
--repo <url> No Enlace de control de código fuente. Omitir para Git administrado por la plataforma (GRS) (predeterminado). Pase una dirección URL completa https:// de un repositorio propiedad de una organización de GitHub Enterprise Cloud, por ejemplo, https://contoso.ghe.com/contoso/my-app o https://github.com/contoso/my-app - para clonar y enlazar un repositorio de GitHub externo vacío existente. Pasar none para omitir todo el enlace de Git (andamiaje de la plantilla y solo escritura ms.config.json , sin repositorio local o remoto). No se puede combinar con --repository-id.
--repository-id <id> -r No Id. de repositorio que se va a asociar a la aplicación para el control de código fuente. No se puede combinar con --repo.
--build-path <path> -b No Directorio de salida de compilación. Valores predeterminados de ./dist.
--build-command <cmd> -S No Comando de shell completo usado para crear la aplicación. Valores predeterminados de npm run build.
--build-entry-point <file> No Archivo HTML de punto de entrada. Valores predeterminados de index.html.
--open-browser No Mejor esfuerzo Inicie el explorador del sistema si necesita volver a autenticar el flujo de código del dispositivo. No tiene ningún efecto con --json.
--force-reauth No Omita la asignación de GitHub almacenada y fuerce el flujo de código del dispositivo, como si la asignación hubiera expirado. Solo afecta a las aplicaciones enlazadas a un repositorio externo de GitHub.

Nota:

  • Para --repo <url>, la CLI clona el repositorio externo de GitHub en el directorio y superpone la plantilla. El repositorio debe existir y estar vacío.
  • Para --repo none, la CLI aplica scaffolding a la plantilla y escribe, ms.config.json pero no inicializa, un repositorio de Git local ni enlaza un remoto. Esto crea una aplicación para la implementación de artefactos externos que usted mismo compila e implementa. Para obtener un ejemplo, consulte Implementar aplicaciones de tiempo de ejecución administrado de Microsoft Copilot con Acciones de GitHub.
  • Si falta la asignación de GitHub o esta expira, ms app create ejecuta el flujo de código del dispositivo en banda y vuelve a intentarlo una vez.

ms app init

Registrar un proyecto web existente como una aplicación sin archivos de scaffolding.

ms app init --display-name <name> [options]

ms app init parámetros

Parámetro Alias ¿Necesario? Description
--display-name <name> -n Sí Nombre para mostrar de la aplicación.
--environment-id <id> -e No Entorno de destino. El valor predeterminado es el entorno de desarrollador del usuario.
--description <text> -d No Descripción de texto libre.
--build-path <path> -b No Directorio de salida de compilación. Valores predeterminados de ./dist.
--build-command <cmd> -S No Comando de shell completo usado para crear la aplicación. Valores predeterminados de npm run build.
--build-entry-point <file> No Archivo HTML de punto de entrada. Valores predeterminados de index.html.
--repo <value> No Comportamiento del repositorio. Omita detectar automáticamente la configuración de Git actual (y preguntar en modo interactivo). Pass native para forzar un repositorio none administrado por la plataforma (GRS), para la implementación de artefactos externos (sin repositorio administrado por la plataforma) o una dirección URL del repositorio para enlazar a un repositorio de GitHub existente ya clonado en el directorio actual.
--icon-path <path> No Ruta de acceso opcional a un icono de .png aplicación o .jpg , escrito como ms.config.jsoniconPath.
--local-app-url <url> No Dirección URL de desarrollo local opcional, escrita como ms.config.jsonlocalAppUrl.
--open-browser No Mejor esfuerzo inicie el explorador del sistema durante el flujo de código del dispositivo. No tiene ningún efecto con --json.
--force-reauth No Omita la asignación de GitHub almacenada y fuerce el flujo de código de dispositivo en el primer intento. Es útil para recuperar una asignación dañada.

Nota:

  • Se produce un error si el directorio actual ya es una aplicación.
  • No aplica scaffolding a los archivos de plantilla. Depende del comportamiento del control de origen (detectado --repo automáticamente desde el directorio actual cuando se omite).
  • Para la rama externa de GitHub, se aplica la misma autenticación adicional del flujo de código del dispositivo en línea que con ms app create.

ms app clone

Clonar el repositorio Git administrado por la plataforma de una aplicación existente y configurar la autenticación Git para futuras operaciones de captura y envío.

ms app clone --app <app-id> [directory]

ms app clone parámetros

Parámetro Alias ¿Necesario? Descripción
--app <app-id> Sí Id. de aplicación de una aplicación a la que tiene acceso de edición. Úselo ms app list --permission edit para buscar el id. de la aplicación.
[directory] No Directorio de destino. Debe estar vacío. Cuando se omite, la CLI crea un directorio con el nombre para mostrar de la aplicación. Pass . explícitamente para utilizar el directorio actual.

Nota:

ms app clone admite repositorios Git administrados por la plataforma. Para una aplicación que usa un repositorio externo de GitHub o GitHub Enterprise Cloud, úselo git clone <repository-url> en su lugar. No se puede clonar una aplicación que no tenga un enlace de control de código fuente.

Detectar conectores

Use estos comandos para buscar conectores disponibles e inspeccionar sus operaciones antes de agregarlos a la aplicación.

ms connector list

Enumerar los conectores disponibles en un entorno.

ms connector list [--environment-id <id>] [--search <term>] [--only-allowed]

La detección incluye conectores bloqueados por la directiva a menos que pase --only-allowed. La tabla de texto incluye el id. de conector, la marca de compatibilidad tabular y un estado de directiva unificado basado en la prevención de pérdida de datos (DLP) y las directivas avanzadas de conector (ACP). La salida de JSON incluye campos de conector y directiva más detallados.

ms connector list parámetros

Parámetro Alias ¿Necesario? Description
--environment-id <id> -e No Entorno para consultar. Valores predeterminados desde ms.config.json cuando está presente.
--search <term> -s No Filtrar por coincidencia de subcadena en el nombre para mostrar o el id. del conector (sin distinción de mayúsculas y minúsculas).
--only-allowed No Enumerar solo los conectores permitidos por la directiva. De forma predeterminada, la detección incluye conectores bloqueados.

ms connector list-actions

Enumere las operaciones que expone un conector, incluido el estado de prevención de pérdida de datos (DLP) de cada operación.

ms connector list-actions [--environment-id <id>] --connector <connector> [--search <term>]

ms connector list-actions parámetros

Parámetro Alias ¿Necesario? Descripción
--connector <connector> Sí Conector para inspeccionar, especificado por el ID.
--environment-id <id> -e No Entorno para consultar. Valores predeterminados desde ms.config.json cuando está presente.
--search <term> -s No Filtrar por coincidencia de subcadena en el resumen de operaciones o identificador de acción (sin distinción de mayúsculas y minúsculas).

Administrar recursos de la aplicación

Use estos comandos para agregar, quitar y actualizar los orígenes de datos de los que depende la aplicación.

Agregar recursos de aplicación

Ejecute todos los add comandos desde el directorio que contiene la aplicación. De forma predeterminada, ms app add data-source genera modelos y servicios de TypeScript en .generated/


ms app add backend

Agregue un back-end de base de datos de Fabric a la aplicación. Un administrador debe habilitar la integración de Fabric para el entorno antes de ejecutar este comando.

ms app add backend --provider fabric

ms app add backend parámetros

Parámetro Alias ¿Necesario? Descripción
--provider <provider> Sí Proveedor de back-end que se va a agregar. Actualmente, el único valor válido es fabric.

Para conocer los requisitos previos y los detalles sobre el back-end de la base de datos, consulte Integración de Fabric con el tiempo de ejecución administrado de Copilot.


ms app add data-source

Agregue un conector a la aplicación. El comando elige automáticamente entre los orígenes de datos de tabla y acción.

ms app add data-source --connector <connector> [options]

Nota:

  • La CLI agrega conectores no tabulares como acciones automáticamente.
  • La CLI solicita la tabla frente a la acción en modo interactivo para los conectores tabulares. Debe especificar --as en el modo no interactivo.
  • DLP y ACP se ejecutan antes de que el comando añada cualquier acción o tabla. La CLI filtra las operaciones bloqueadas e informa del recuento omitido.

ms app add data-source parámetros

Parámetro Alias ¿Necesario? Descripción
--connector <connector> Sí Conector que se va a agregar, por Id. (por ejemplo, shared_office365) o nombre para mostrar, desde ms connector list.
--as <mode> Condicional Forzar table o action enviar. Se requiere en el modo no interactivo cuando el conector admite tablas.
--connection-id <id> -c No Conexión existente que se va a usar. El aviso de CLI cuando se omite.
--dataset <name> -d No Conjunto de datos (usado con --as table).
--table <name> -t No Tabla para agregar (se usa con --as table). Para Dataverse (shared_commondataserviceforapps), el nombre lógico de la tabla.
--dataverse-environment-id <guid> No Id. de entorno de Dataverse. Solo se usa con --connector shared_commondataserviceforapps para enlazar a una tabla específica.
--use-sso No Prefiera una conexión de inicio de sesión único (Entra ID): reutilice la primera conexión SSO existente o cree una de forma silenciosa. Errores si el conector no es compatible con SSO. Se omite cuando --connection-id se proporciona.

Eliminación de recursos de la aplicación

En el modo interactivo, los comandos de eliminación piden confirmación a menos que pase --force. En el modo no interactivo, la eliminación continúa sin confirmación incluso cuando se omite --force.

ms app remove data-source

Quite un origen de datos agregado previamente (tabla o acción) de la aplicación.

ms app remove data-source [--name <name>] [--force]

ms app remove data-source parámetros

Parámetro Alias ¿Necesario? Description
--name <name> -n No Nombre del origen de datos que se va a quitar. La CLI le pide que elija entre los orígenes de datos de la aplicación cuando se omiten.
--force -f No Omite la confirmación del mensaje.

Actualizar los recursos de la aplicación

Use este comando para sincronizar los tipos de aplicaciones generados con los últimos cambios de esquema de origen.

ms app refresh data-source

Recupere el esquema y regenere TypeScript para los orígenes de datos enlazados.

ms app refresh data-source [--name <name>]

Ejecute este comando después de que cambie el esquema subyacente (por ejemplo, una nueva columna en una lista de SharePoint) para mantener sincronizado el TypeScript generado.

ms app refresh data-source parámetros

Parámetro Alias ¿Necesario? Description
--name <name> -n No Actualizar un origen de datos específico. Omita actualizar todos los orígenes enlazados.

Desarrollo local

Use estos comandos para ejecutar la aplicación localmente con el servidor de configuración para un desarrollo iterativo.

ms app dev

Iniciar el ciclo completo de desarrollo local.

ms app dev [--port <n>] [--local-app-url <url>] [--config-only]

La CLI inicia el proceso de desarrollo del proyecto junto con un servidor de configuración local. La dirección URL de reproducción se imprime una vez que ambos son accesibles. Presione Ctrl+C para detenerlos limpiamente.

ms app dev parámetros

Parámetro Alias ¿Necesario? Description
--port <n> -p No Puerto para el servidor de configuración. Valores predeterminados de 8080.
--local-app-url <url> -l No Dirección URL a la que se puede acceder al servidor de desarrollo. Valores predeterminados de http://localhost:3000.
--config-only -C No Inicie solo el servidor de configuración, para cuando ejecute el servidor de desarrollo por separado (por ejemplo, en un administrador de procesos).

Compilar e implementar

Use estos comandos para empaquetar localmente, ejecutar compilaciones remotas e implementar una confirmación validada.

ms app pack

Cree la aplicación localmente y almacene provisionalmente la salida para su inspección sin cargarla en ningún lugar.

ms app pack

Use este comando para comprobar que una compilación local limpia se realiza correctamente antes de desencadenar una compilación remota.


ms app build

Desencadenar una compilación de plataforma para una confirmación específica en una aplicación respaldada por Git.

ms app build --app <name> --commit <sha> [--no-wait] [--open-browser] [--force-reauth]

ms app build parámetros

Parámetro Alias ¿Necesario? Descripción
--app <name> No Nombre de la aplicación. Valores predeterminados desde ms.config.json cuando está presente.
--commit <sha> -c No Comprométete con la compilación. El valor predeterminado es el archivo web actual HEAD.
--no-wait No Regrese inmediatamente después del envío e imprima una sugerencia para realizar un seguimiento con ms app build-status. De forma predeterminada, el comando espera a que la compilación alcance un estado terminal.
--open-browser No Mejor esfuerzo Inicie el explorador del sistema si es necesario volver a autenticar el flujo de código del dispositivo para repositorios externos de GitHub. No tiene ningún efecto con --json.
--force-reauth No Omita la asignación de GitHub almacenada y fuerce el flujo de código del dispositivo. Solo afecta a las aplicaciones enlazadas a un repositorio externo de GitHub.

ms app build-status

Comprobar el estado de una compilación.

ms app build-status --app <name> --commit <sha> [--show-log]

Si se produjo un error en la compilación, el resultado incluye el motivo para que pueda corregir el código y volver a insertar.

ms app build-status parámetros

Parámetro Alias ¿Necesario? Descripción
--app <name> No Aplicación que se va a inspeccionar. Valores predeterminados desde ms.config.json cuando está presente.
--commit <sha> -c No Comprométete a comprobar el estado de la compilación. El valor predeterminado es el archivo web actual HEAD.
--show-log No Recupere e imprima el registro de compilación cuando esté disponible.

ms app deploy

Promueva una compilación ecológica en la aplicación activa.

ms app deploy [--app <name>] [--commit <sha>] [--artifact <path>] [--force] [--open-browser] [--force-reauth]

Nota:

  • El comando se implementa en el entorno asociado a la aplicación. No selecciona un entorno de implementación.
  • En el caso de las aplicaciones respaldadas por Git, la CLI resuelve la confirmación (Git HEADlocal predeterminado), pone en cola una compilación remota o reutiliza una compilación en caché para esa confirmación, espera la finalización e implementa esa misma confirmación. Una compilación fallida o cancelada detiene la implementación; la CLI no selecciona una compilación anterior correcta.
  • Si la comprobación tiene cambios no confirmados o confirmaciones locales antes que el remoto, la comprobativa pregunta "¿Implementar de todos modos?" en modo interactivo. En el modo no interactivo o JSON, se detiene con un error de uso a menos que pase --force. Confirme e inserte los cambios previstos antes de la implementación. --force omite el vuelo previo; No carga una fuente no confirmada o no insertada.
  • En el caso de las aplicaciones sin control de código fuente (repoType: none), la CLI empaqueta y carga la compilación local, o bien carga una versión precompilada .zip cuando --artifact se proporciona.

ms app deploy parámetros

Parámetro Alias ¿Necesario? Descripción
--app <name> No Aplicación que se va a implementar. Defaults from ms.config.json.
--commit <sha> -c No Confirmar la implementación (solo aplicaciones respaldadas por Git). El valor predeterminado es el archivo web actual HEAD. Mutuamente excluyente con --artifact.
--artifact <path> No Ruta de acceso a un artefacto de compilación local .zip para cargar e implementar. Solo es válido para aplicaciones creadas sin control de código fuente (repoType: none); rechazado en aplicaciones respaldadas por Git. Mutuamente excluyente con --commit.
--force No Omitir confirmación o rechazo de comprobación previa de Git para cambios no confirmados o confirmaciones locales antes del remoto. No carga esos cambios.
--open-browser No Mejor esfuerzo Inicie el explorador del sistema si necesita volver a autenticar el flujo de código del dispositivo. No tiene ningún efecto con --json.
--force-reauth No Omita la asignación de GitHub almacenada y fuerce el flujo de código del dispositivo. Solo afecta a las aplicaciones enlazadas a un repositorio externo de GitHub.

Hasta que finalice la implementación, la implementación existente permanece intacta y se puede usar. Una vez completada la implementación, los usuarios finales ven una notificación de que hay una nueva versión disponible con un vínculo para actualizar la aplicación.

ms app deploy --artifact <path> Carga e implementa el artefacto sin una compilación administrada por la plataforma. La implementación de artefactos externos no está permitida de forma predeterminada. Consulta Implementación de artefactos externos. Su organización es responsable de validar los artefactos creados externamente y proteger la canalización de compilación antes de la implementación.

Play

Use este comando para abrir la aplicación en modo en directo o en versión preliminar.

ms app play

Abre una aplicación en el explorador e imprime su URL de inicio.

ms app play [--app <name>] [--mode live | preview] [--commit <sha> | --branch <name>] [--no-browser]

ms app play parámetros

Parámetro Alias ¿Necesario? Descripción
--app <name> No aplicación que se abra. Defaults from ms.config.json.
--mode <mode> -m No live Abre la aplicación implementada. preview abre la rama de Git actual de forma predeterminada, o la rama o confirmación que especifique. Valores predeterminados de live.
--commit <sha> -c No Abra la vista previa en una confirmación específica. Válido solo con --mode preview. Mutuamente excluyente con --branch.
--branch <name> No Abrir la vista previa de una rama específica. Válido solo con --mode preview. El valor predeterminado es la rama Git actual; si la CLI no puede identificarla, advierte y vuelve a main. Mutuamente excluyente con --commit.
--no-browser No Imprima la dirección URL de inicio sin abrir el explorador predeterminado. Es útil para sesiones SSH, CI y scripts.

Nota:

--mode live Advierte de que la compilación activa es una instantánea y no se actualiza automáticamente. Vuelva a ejecutar ms app deploy para actualizarlo. Si no hay ninguna URL de reproducción disponible, se produce un error en el comando. Si una URL existe, pero el destino no tiene ninguna confirmación implementada, el comando advierte y aún imprime y abre la URL.

Vista previa del comportamiento de la compilación

En --mode preview, la dirección URL de inicio se basa en la confirmación del encabezado de la rama actual o en una SHA de confirmación seleccionada. Lo que ve en el explorador para esa dirección URL depende del estado de la compilación de esa confirmación:

Estado de compilación Comportamiento de vista previa
La última confirmación tiene una compilación correcta Representa la compilación.
La última confirmación aún se está compilando Representa la compilación correcta anterior con un banner en curso: "La compilación más reciente está en curso".
Error en la última confirmación al compilar Representa la compilación correcta anterior con un banner de error: "Error en la compilación más reciente. Mostrando la última compilación exitosa".
La aplicación aún no tiene una compilación correcta Representa una experiencia dedicada "nunca implementada".

Compartir

Use estos comandos para conceder, revocar y administrar el acceso a la aplicación y compartir vínculos.

ms app share

Conceder acceso a usuarios o grupos.

ms app share <principals> [--app <name>] [--access play | edit]

El comando busca automáticamente direcciones de correo electrónico. Notifica las advertencias para las entradas que no se resuelven, pero continúa con las que sí lo hacen. Si no se resuelve ninguna entrada, se produce un error en el comando.

ms app share parámetros

Parámetro Alias ¿Necesario? Descripción
<principals> Sí lista separada por comas de direcciones de correo electrónico o identificadores de objeto de Microsoft Entra.
--app <name> No App para compartir. Defaults from ms.config.json.
--access <level> No Conceder acceso en tiempo de ejecución (play, predeterminado) o acceso de colaborador (edit). El acceso de edición incluye permisos de repositorio para Git administrado por la plataforma; el acceso externo al repositorio de GitHub se debe conceder por separado en GitHub.

ms app unshare

Revocar el acceso concedido anteriormente.

ms app unshare <principals> [--app <name>] [--access play | edit]

El unshare comando solo afecta al nivel de acceso solicitado. Por ejemplo, unshare --access edit deja intacto el play acceso. Las entidades de seguridad sin una asignación de roles existente en el nivel solicitado son no-ops.

En el caso de las aplicaciones respaldadas por GitHub, revoque el acceso al repositorio externo por separado en GitHub. Dejar de compartir la aplicación no quita los permisos de GitHub concedidos de forma independiente.

ms app unshare parámetros

Parámetro Alias ¿Necesario? Descripción
<principals> Sí lista separada por comas de direcciones de correo electrónico o identificadores de objeto de Microsoft Entra.
--app <name> No Aplicación para dejar de compartir. Defaults from ms.config.json.
--access <level> No Revocar el acceso en tiempo de ejecución (playpredeterminado) o el acceso de colaborador (edit). El acceso de edición incluye permisos de repositorio para Git administrado por la plataforma, pero no permisos de repositorio externo de GitHub.

ms app share list

Enumerar los usuarios y grupos con los que se comparte una aplicación en un nivel de acceso determinado.

ms app share list --access <level> [--app <name>] [--environment-id <id>]

ms app share list parámetros

Parámetro Alias ¿Necesario? Descripción
--access <level> Sí Nivel de acceso a la lista. O play bien (ejecutar la aplicación) o edit (contribuir a la aplicación). En el caso de las aplicaciones respaldadas por GitHub, esta lista no establece el acceso al repositorio externo.
--app <name> No Aplicación que se va a inspeccionar. Defaults from ms.config.json.
--environment-id <id> -e No Invalide el identificador de entorno. Valores predeterminados desde ms.config.json cuando está presente.

Cree un vínculo para compartir en todo el inquilino para la aplicación.

ms app share link create [--app <name>] [--environment-id <id>]
Parámetro Alias ¿Necesario? Descripción
--app <name> No App para compartir. Defaults from ms.config.json.
--environment-id <id> -e No Invalide el identificador de entorno. Valores predeterminados desde ms.config.json cuando está presente.

Enumerar los vínculos de recurso compartido emitidos para la aplicación.

ms app share link list [--app <name>] [--environment-id <id>]
Parámetro Alias ¿Necesario? Descripción
--app <name> No Aplicación que se va a inspeccionar. Defaults from ms.config.json.
--environment-id <id> -e No Invalide el identificador de entorno. Valores predeterminados desde ms.config.json cuando está presente.

Revocar un vínculo para compartir por id. Este comando quita todos los roles del redentor anterior antes de destruir el registro del vínculo.

ms app share link revoke --link-id <id> [--app <name>] [--environment-id <id>] [--force]
Parámetro Alias ¿Necesario? Description
--link-id <id> -l Sí El id. del vínculo devuelto de ms app share link create.
--app <name> No Aplicación propietaria del vínculo. Defaults from ms.config.json.
--environment-id <id> -e No Invalide el identificador de entorno. Valores predeterminados desde ms.config.json cuando está presente.
--force -f No Omite la confirmación del mensaje.

Inspección y administración

Use estos comandos para ver el estado de la aplicación, actualizar la configuración y quitar aplicaciones cuando sea necesario.

ms app list

Enumera todas las aplicaciones a las que puedes acceder. De forma predeterminada, el comando enumera todas las aplicaciones del inquilino. Se usa --environment-id para limitar el ámbito de la lista a un único entorno.

ms app list [--environment-id <id>] [--permission <level>]

Devuelve los detalles de la aplicación, como el nombre para mostrar y el id. de la aplicación.

ms app list parámetros

Parámetro Alias ¿Necesario? Description
--environment-id <id> -e No Limite la lista a un único entorno. Cuando se omite, el comando devuelve todas las aplicaciones a las que puede tener acceso en el inquilino.
--permission <level> -p No Filtro de permisos. Use ( edit aplicaciones a las que puede contribuir) o play (aplicaciones a las que puede jugar o ver). No distingue mayúsculas de minúsculas.

ms app info

Muestra el estado de la aplicación del lado servidor.

ms app info [--app <name>] [--environment-id <id>]

Devuelve el nombre para mostrar, la descripción opcional, el id. del entorno, el id. de la aplicación, el id. del proyecto, la confirmación implementada abreviada a siete caracteres, los conectores y los detalles opcionales del repositorio. No devuelve propietarios ni URL de inicio.

Para obtener las direcciones URL de inicio sin abrir un explorador, usa ms app play --no-browser el modo en directo o ms app play --mode preview --no-browser el modo de vista previa. Agregar --json para obtener una salida estructurada. Para inspeccionar la configuración local real, abra el estado del servidor de ms.config.jsonms app info informes.

ms app info parámetros

Parámetro Alias ¿Necesario? Descripción
--app <name> No Nombre de la aplicación que se va a inspeccionar. Defaults from ms.config.json. Pase un nombre explícito para inspeccionar una aplicación fuera del directorio de trabajo actual.
--environment-id <id> -e No Invalide el identificador de entorno. Valores predeterminados desde ms.config.json; cuando no se establece ninguno, el entorno se resuelve automáticamente a partir del nombre de la aplicación.

ms app get-settings

Muestra la configuración de la aplicación y sus valores actuales.

ms app get-settings

Más información sobre cómo ver la configuración de la aplicación


ms app set-setting

Actualiza una o varias opciones de configuración de la aplicación.

ms app set-setting [--show-header <bool>] [other-settings...]

Pasar la configuración como marcas con nombre. Solo se actualizan las claves especificadas.

ms app set-setting parámetros

Parámetro Alias ¿Necesario? Descripción
--show-header <bool> No Mostrar u ocultar la barra de encabezado de la aplicación.
[other-settings...] No Una o más marcas de configuración con nombre que se van a actualizar. Solo se cambian las claves proporcionadas.

Aprende a configurar los valores de una aplicación


ms app delete

Elimina la aplicación del entorno. Este comando no elimina el código fuente local ni el repositorio de Git.

ms app delete [--app <name>] [--environment-id <id>] [--force]

Si la aplicación no existe, el comando se cierra limpiamente sin un error.

ms app delete parámetros

Parámetro Alias ¿Necesario? Descripción
--app <name> No Aplicación que se va a eliminar. Defaults from ms.config.json.
--environment-id <id> -e No Invalide el identificador de entorno. Cuando se omite, el entorno se resuelve automáticamente desde la aplicación. Útil para eliminar una aplicación desde fuera de su directorio con scaffolding.
--force -f No Omite la confirmación del mensaje.

Administración

Use estos comandos para agregar o quitar propietarios de aplicaciones. Para obtener un procedimiento paso a paso, consulte Reasignar propietarios de aplicaciones.

Nota:

Estos comandos requieren un repositorio Git administrado por la plataforma y permisos de administrador global o administrador de Power Platform.

ms admin add owner

Agregue uno o varios propietarios de aplicaciones sin quitar los propietarios existentes ni cambiar otras asignaciones de roles.

ms admin add owner <principals...> --app <app-id> [--force]

ms admin add owner parámetros

Parámetro Alias ¿Necesario? Descripción
<principals...> Sí Una o varias direcciones de correo electrónico o identificadores de objeto de Microsoft Entra, separados por espacios o comas. Para una entidad de servicio, use su identificador de objeto. Acepta hasta 100 entidades de seguridad únicas.
--app <app-id> Sí Id. de aplicación en formato GUID. Debe proporcionarse explícitamente; no se lee desde la configuración local. La CLI detecta automáticamente el entorno de la aplicación.
--force -f No Omita la pregunta de confirmación. No es necesario al agregar propietarios en modo JSON o no interactivo.

En el modo interactivo, el comando pide confirmación a menos que especifique --force. En modo JSON o no interactivo, se ejecuta sin pedir confirmación.

Por ejemplo, para agregar un segundo propietario:

ms admin add owner newowner@contoso.com --app <app-id>

Para agregar varios propietarios sin previo aviso:

ms admin add owner newowner@contoso.com backupowner@contoso.com --app <app-id> --force --json

ms admin remove owner

Quite las asignaciones de propietarios de aplicaciones coincidentes sin asignar automáticamente un rol menor. Otras asignaciones de rol, como el acceso de colaborador, permanecen sin cambios, por lo que la persona podría conservar el acceso a través de otro rol.

ms admin remove owner <principals...> --app <app-id> [--force]

ms admin remove owner parámetros

Parámetro Alias ¿Necesario? Descripción
<principals...> Sí Una o varias direcciones de correo electrónico o identificadores de objeto de Microsoft Entra, separados por espacios o comas. Para una entidad de servicio, use su identificador de objeto. Acepta hasta 100 entidades de seguridad únicas.
--app <app-id> Sí Id. de aplicación en formato GUID. Debe proporcionarse explícitamente; no se lee desde la configuración local. La CLI detecta automáticamente el entorno de la aplicación.
--force -f Condicional Omita la pregunta de confirmación. Requerido con --json o --non-interactive. No omite la autorización ni la protección del último propietario.

En el modo interactivo, el comando pide confirmación a menos que especifique --force. Si no se encuentra ninguna asignación de propietario coincidente, el comando se ejecuta correctamente sin quitar nada. Si la coincidencia por correo electrónico no encuentra la tarea, vuelva a intentarlo con el identificador de objeto de Microsoft Entra de la persona.

Por ejemplo, para quitar a un propietario:

ms admin remove owner formerowner@contoso.com --app <app-id>

Para eliminar un propietario en la automatización:

ms admin remove owner <object-id> --app <app-id> --force --json

Importante

Antes de quitar un propietario, verifique que otro propietario pueda mantener la aplicación. Al reasignar la propiedad, agregue y compruebe primero el propietario de reemplazo. La plataforma le impide eliminar al último propietario de la aplicación; --force Solo omite la confirmación.

Los informes de resultados eliminaron asignaciones, entidades de seguridad no asignadas y asignaciones omitidas. Revise el resultado en lugar de asumir que se han quitado todos los propietarios solicitados. Si se produce un error en una solicitud, compruebe las asignaciones actuales antes de volver a intentarlo, porque es posible que algunos cambios ya se hayan aplicado.

Telemetría

La CLI envía telemetría anónima de forma predeterminada. Use estos comandos para controlar la recopilación.


ms telemetry enable

Activa la recopilación de telemetría.

ms telemetry enable [--remote] [--console]

ms telemetry enable parámetros

Parámetro Alias ¿Necesario? Descripción
--remote No Controla el envío de telemetría al servicio remoto. Esta opción es la predeterminada cuando no se da ninguna marca.
--console No Print telemetry events to the local console.

Pasa ambas banderas para alternar ambos objetivos a la vez.


ms telemetry disable

Desactiva la recopilación de telemetría.

ms telemetry disable [--remote] [--console]

ms telemetry disable parámetros

Parámetro Alias ¿Necesario? Descripción
--remote No Deja de enviar telemetría al servicio remoto. Esta opción es la predeterminada cuando no se da ninguna marca.
--console No Dejar de imprimir eventos de telemetría en la consola local.

Pasa ambas banderas para deshabilitar ambos objetivos a la vez.


ms telemetry status

Mostrar la configuración de telemetría actual.

ms telemetry status