Compartir a través de

Solución de problemas de la CLI de Microsoft Power Platform

Obtenga información sobre algunos pasos que puede seguir para solucionar problemas si la CLI de Power Platform no funciona correctamente. Este artículo contiene información sobre:

Uso del parámetro global --log-to-console

El parámetro global --log-to-console envía a la salida de la consola los registros de diagnóstico de la CLI de PAC, de modo que estos son capturados inmediatamente por los registros de canalización.

pac --log-to-console <noun> <verb> [parameters]

Cuándo usar este parámetro

Utilice --log-to-console si:

  • Está ejecutando la CLI de PAC en ejecutores efímeros (por ejemplo, ejecutores hospedados en GitHub) donde los archivos locales se descartan cuando finaliza el trabajo.
  • Se produce un error en una canalización antes de que un paso de carga de registros independiente pueda publicar registros de la CLI de PAC locales.
  • Necesita diagnósticos inmediatos en los registros de trabajos de Acciones de Azure DevOps o GitHub para evaluar las implementaciones con errores.

--log-to-console es un parámetro global de la CLI de PAC. Esto significa que puede usarlo con cualquier comando de la CLI de PAC.

Examples

- name: Import solution with PAC CLI diagnostics
  run: pac --log-to-console solution import --path ContosoSolution.zip --environment ${{ secrets.ENVIRONMENT_URL }}

Nota:

El pac package deploy comando también tiene parámetros de registro específicos del comando (--logConsole y --logFile) para la salida de implementación de paquetes.

Falta de DotnetToolSettings.xml

Si se produce un error en un comando de la CLI de PAC con un DotnetToolSettings.xml mensaje que falta, la versión instalada de .NET normalmente no coincide con la versión principal de la CLI de PAC.

Este comportamiento conocido de la herramienta .NET se rastrea en el problema dotnet/sdk n.º 38172.

Causa

  • La CLI de PAC 2.x y versiones posteriores se compilan con .NET 10 y requieren que .NET 10 se instale como requisito previo.
  • Las versiones de la CLI de PAC 1.x se compilan con .NET 9 y requieren que .NET 9 se instale como requisito previo.
  • Si la versión de .NET necesaria no está instalada, el error puede aparecer como DotnetToolSettings.xml ausente en lugar de un mensaje en tiempo de ejecución más claro.
  • Incluso cuando se instalan varios SDK, un entorno local global.json puede forzar dotnet el uso de un SDK anterior que no pueda ejecutar la herramienta.
  • Algunos usuarios informaron de este problema con los trenes de parches del SDK más antiguos. La actualización a las revisiones más recientes del SDK puede resolver el problema.

Cómo corregirlo

Siga estos pasos para corregir este error.

  1. Compruebe la versión de la CLI de PAC:

    pac

  2. Instale el SDK de .NET o el entorno de ejecución necesarios para esa versión principal de la CLI de PAC:

    • CLI de PAC 2.x o posterior:> instala .NET 10
    • CLI de PAC 1.x:> instalación de .NET 9

  3. Compruebe que el SDK necesario está disponible en la máquina o en el agente de compilación:

    dotnet --list-sdks

  4. Compruebe si dotnet está anclado por global.json en el árbol de directorios actual:

    dotnet --info

    Si global.json apunta a un SDK anterior, actualícelo o ejecútelo desde un directorio que no ancle un SDK incompatible.

  5. Vuelva a ejecutar el comando de la CLI de PAC.

En los sistemas de CI (GitHub Actions y Azure DevOps), instale explícitamente la versión necesaria de .NET en la canalización antes de que se ejecute la Interfaz de Línea de Comandos (CLI) de PAC.

Si ve este error al instalar un paquete diferente (no la CLI de PAC), compruebe que el paquete es un paquete de herramientas de .NET. Los paquetes NuGet que no son de herramientas pueden producir mensajes similares con dotnet tool install.

Consulte también

Visión general del CLI de Microsoft Power Platform
Referencia de comandos de la CLI de Power Platform
Referencia del comando pac package

  • Last updated on