¿Qué es Microsoft Power Platform CLI?

Microsoft Power Platform CLI es una CLI para desarrolladores simple y única que permite a los desarrolladores y proveedores de software independientes (ISV) realizar diversas operaciones Microsoft Power Platform relacionadas con:

• Ciclo de vida del entorno
• Autenticación
• Entornos de Microsoft Dataverse
• Paquetes de soluciones
• Power Pages
• Componentes de 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 maneras 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 Visual Studio Code	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 usando SOLO este método, de manera predeterminada, la CLI de PAC solo está disponible dentro de un terminal de Visual Studio Code a menos que habilite la CLI de PAC en las terminales del símbolo del sistema (CMD) y PowerShell para Windows.
Instalar con .NET Tool	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 de 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
• pac package show

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

• Extensión de Visual Studio Code
• Windows MSI

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.

Windows

1. Abra una terminal de PowerShell:

   • Si SOLO ha instalado la extensión de Visual Studio Code, abra una ventana de terminal de PowerShell de Visual Studio Code.
   • Si ha realizado la instalación con la herramienta .NET Tool, abra una terminal de PowerShell de Visual Studio Code 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, aparece 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 el Terminal/Símbolo del sistema, escriba which pac en el mensaje y presione Entrar.

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 Entrar.

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. Necesita 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

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

Cuando se configura utilizando las siguientes instrucciones, puede escribir solo el comienzo de un comando y luego usar la tecla Tabulador para completar la entrada introducida.

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 la función de completar con tabuladores 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 ahora está disponible para su uso en las regiones GCC y GCC High (US Sovereign Cloud). 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:

Grupos de comandos de Microsoft Power Platform CLI

Vea también

Notas de la versión de Microsoft Power Platform CLI
Grupos de comandos de Microsoft Power Platform CLI
Solución de problemas de la CLI de Microsoft Power Platform
Marco de componentes de Power Apps