¿Qué es Microsoft Power Platform CLI?

Microsoft Power Platform CLI es una CLI para desarrolladores sencilla y única que permite a los desarrolladores e ISV realizar varias operaciones en Microsoft Power Platform relacionadas con:

• Ciclo de vida del entorno
• Autenticación
• Entornos de Microsoft Dataverse
• Paquetes de soluciones
• Power Pages
• Componentes del código
• etcétera...

Proporcionar comentarios

Utilice github.com/microsoft/powerplatform-build-tools/discussions para ver y enviar comentarios sobre PAC CLI.

Instalar Microsoft Power Platform CLI

Existen tres formas de instalar Power Platform CLI: Puede utilizar varios métodos de instalación en el mismo ordenador.

método	Soporte de SO	Descripción
Instalar la extensión de código Visual Studio	Windows, Linux, macOS	Permite el uso de comandos dentro de un terminal de PowerShell en Visual Studio Code en Windows 10, Windows 11, Linux y macOS. Cuando realiza la instalación utilizando SOLO este método, de forma predeterminada, PAC CLI solo estará disponible dentro de una terminal de Visual Studio Code a menos que habilite PAC CLI en el símbolo del sistema (CMD) y terminales PowerShell para Windows
Instalar con la herramienta .NET	Windows, Linux, macOS	Permite el uso de comandos dentro de un shell PowerShell, CMD o Bash en Windows 10, Windows 11, Linux y macOS. Este método de instalación no permite el uso de comandos pac data o ciertos comandos pac package (deploy y show) que sólo están disponibles para Windows.
Instalar con Windows MSI	Solo Windows	Permite el uso de comandos dentro de un terminal PowerShell dentro Visual Studio Code solo en Windows. Puede administrar versiones instaladas con este método de instalación.

Nota

Los siguientes comandos solo están disponibles en Windows:

• datos pac
• Despliegue del paquete pac
• paquete pac mostrar

Para usar estos comandos en Windows, instale Power Platform CLI utilizando uno (o ambos) de estos métodos de instalación:

• Visual Studio Extensión de código
• MSI de Windows

Estos comandos no están disponibles en Windows si solo los instala usando .NET Tool.

Comprobar si Power Platform CLI ya está instalado

Cómo determinar si Power Platform CLI está instalado depende de su sistema operativo.

Ventanas

1. Abra una terminal de PowerShell:

   • Si SÓLO instaló la extensión de Visual Studio Code, abra una ventana de terminal de Visual Studio Code Powershell.
   • Si lo instaló usando .NET Tool, abra una terminal de Visual Studio Code PowerShell o una terminal de Powershell.

2. Escriba Get-Command pac | Format-List en la solicitud y pulse Intro.

El resultado deberá ser ahora similar a esto:

Name            : pac.exe
CommandType     : Application
Definition      : C:\Users\you\.dotnet\tools\pac.exe
Extension       : .exe
Path            : C:\Users\you\.dotnet\tools\pac.exe
FileVersionInfo : File:             C:\Users\you\.dotnet\tools\pac.exe
                  InternalName:     pac.dll
                  OriginalFilename: pac.dll
                  FileVersion:      1.29.11
                  FileDescription:  Microsoft Power Platform CLI
                  Product:          Microsoft Power Platform©
                  ProductVersion:   1.29.11+g9e2b163
                  Debug:            False
                  Patched:          False
                  PreRelease:       False
                  PrivateBuild:     False
                  SpecialBuild:     False
                  Language:         Language Neutral

Cuando Power Platform CLI no está instalado, obtendrá este error:

Get-Command: The term 'pac' is not recognized as a name of a cmdlet, function, script file, or executable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

Linux/macOS

Para ver si Power Platform CLI está instalado en Linux o macOS, abra la Terminal/Símbolo del sistema, escriba which pac cuando se le indique y presione Intro.

El resultado deberá ser ahora similar a esto:

/home/you/.dotnet/tools/pac

Compruebe qué versión de Power Platform CLI está instalada

Abra el símbolo del sistema (en Microsoft Windows), o una sesión de Terminal (en Linux), escriba pac y pulse Intro.

Debería ver algo como esto donde la versión está en la segunda línea.

Microsoft PowerPlatform CLI
Version: 1.30.3+g0f0e0b9

Administrar perfiles de autenticación

La mayoría de los comandos de PAC CLI requieren acceso autenticado a los recursos. Deberá crear y utilizar perfiles de autenticación.

Nota

Con la extensión Visual Studio Code, puede ver y administrar perfiles de autenticación.

Conéctese a su inquilino

Utilice el comando pac auth create para conectarse a su inquilino. Al ejecutar pac auth create se crea un perfil de autenticación en su máquina. Puede tener varios perfiles de autenticación disponibles. Tener varios perfiles de autenticación es interesante cuando se trabaja con varios inquilinos. Por ejemplo, cuando su empresa utiliza varios inquilinos (para desarrollo, producción y pruebas) o cuando es un consultor que trabaja para varios clientes.

El comando pac auth create tiene un par de parámetros útiles:

• El parámetro --environment le permite conectarse automáticamente al entorno correcto. Si omite el parámetro --environment, está conectado al entorno predeterminado, pero con el parámetro --environment agregado, puede conectarse a uno diferente. Puede utilizar el ID del entorno, la URL, el nombre único o el nombre parcial como valor.

• En entornos donde no tiene la capacidad de usar un experiencia interactiva, agregar el parámetro --deviceCode asegura que aún pueda conectarse. Por ejemplo, en GitHub Codespaces, el parámetro --deviceCode se agrega automáticamente cuando ejecuta pac auth create.

Ejemplo

Para conectarse al entorno HR-Dev, puede utilizar el siguiente ejemplo:

pac auth create --environment "HR-Dev"

Cambiar a otro perfil de autenticación

Cuando tiene varios perfiles de autenticación, puede cambiar fácilmente usando los comandos pac auth list y pac auth select.

El comando pac auth list enumera todos los perfiles de autenticación en su máquina. El comando pac auth select selecciona un comando diferente.

pac auth list Ejemplo

Para enumerar todos los perfiles de autenticación, use el ejemplo siguiente:

pac auth list

Al ejecutar el comando pac auth list se devuelven todos los perfiles de autenticación:

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

Seleccione un perfil de autenticación diferente utilizando el valor del índice.

pac auth select --index 2

Habilitar la finalización de pestañas en PowerShell

La CLI de Power Platform tiene un comando pac complete similar al comando complete de la CLI de .NET.

Cuando se configura usando las instrucciones a continuación, puede escribir solo el comienzo de un comando y luego usar la tecla Tab para completar la entrada ingresada.

Para agregar la finalización de pestañas a PowerShell para la CLI de PAC, cree o edite el perfil almacenado en la variable $PROFILE. Para obtener más información, consulte Cómo crear su perfil y Perfiles y política de ejecución.

Agregue el código siguiente a su perfil:

$scriptblock = {
    param($wordToComplete, $commandAst, $cursorPosition)

    &pac complete -s "$($commandAst.ToString())" | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
    }
}

Register-ArgumentCompleter -Native -CommandName pac -ScriptBlock $scriptblock

Otros Shells

También puede usar esto con bash, zsh, fish y nushell. En lugar de dotnet complete, use pac complete

Disponibilidad de la nube soberana de EE. UU.

Microsoft Power Platform CLI está disponible para su uso en las regiones GCC y GCC High (nube soberana de EE. UU.). Consulte el parámetro --cloud para el comando pac auth create para conocer los entornos de nube soberanos de EE. UU. compatibles.

Pasos siguientes

Más información sobre los comandos. Para obtener la lista completa de comandos compatibles, ejecute el comando pac help o pac <subcommand> help; por ejemplo: pac solution help.

O vea la lista de comandos en la documentación:

Microsoft Power Platform Grupos de comandos de la CLI

Consulte también

Microsoft Power Platform Notas de la versión de CLI
Microsoft Power Platform Grupos de comandos de la CLI
Power Apps marco de componentes