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:

  • Cuándo y cómo usar el parámetro
  • Cómo resolver un error que indica que falta el archivo

Uso del parámetro global

El parámetro global 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 si:

  • Está ejecutando la CLI de PAC en ejecutores efímeros (por ejemplo, ejecutores hospedados por 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 Azure DevOps o Acciones de GitHub para diagnosticar los fallos en las implementaciones.

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 comando también tiene parámetros de registro específicos del comando ( y ) para la salida de implementación de paquetes.

Resuelve la falta de

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

Se realiza un seguimiento de este comportamiento conocido de la herramienta .NET en do tnet/sdk problema #38172.

Causa

  • La CLI de PAC 2.x y versiones posteriores se compilan con .NET 10 y requieren que se instale .NET 10 como requisito previo.
  • Las versiones de la CLI de PAC 1.x se compilan con .NET 9 y requieren que se instale .NET 9 como requisito previo.
  • Si la versión .NET necesaria no está instalada, el error puede aparecer como DotnetToolSettings.xml falta en vez de un mensaje en tiempo de ejecución más claro.
  • Incluso cuando se instalan varios SDK, un entorno local puede forzar 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 o el entorno de ejecución de .NET necesarios para esa versión principal de la CLI de PAC:

    • PAC CLI 2.x o posterior -> instalar .NET 10
    • CLI de PAC 1.x -> instale .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 está anclado por en el árbol de directorios actual:

    dotnet --info

    Si 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 (Acciones de GitHub y Azure DevOps), instale explícitamente la versión de .NET necesaria en la canalización antes de que se ejecute la 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 .

Consulte también

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

  • Last updated on