Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.jsonpero 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 createejecuta 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
--repoautomá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
- Eliminación de recursos de la aplicación
- Actualizar los recursos de 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
--asen 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.--forceomite 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.zipcuando--artifactse 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. |
ms app share link create
Cree un vínculo para compartir en todo el inquilino para la aplicación.
ms app share link create [--app <name>] [--environment-id <id>]
ms app share link create parámetros
| 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. |
ms app share link list
Enumerar los vínculos de recurso compartido emitidos para la aplicación.
ms app share link list [--app <name>] [--environment-id <id>]
ms app share link list parámetros
| 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. |
ms app share link revoke
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]
ms app share link revoke parámetros
| 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