Compartir a través de

¿Qué es Microsoft Power Platform CLI?

Microsoft Power Platform CLI es una CLI de desarrollador sencilla y única que permite a los desarrolladores y proveedores de software independientes (ISV) realizar diversas operaciones en 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.

Instalación de la CLI de Microsoft Power Platform

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 Visual Studio Code Windows, Linux, macOS Habilita el uso de comandos dentro de un terminal de PowerShell dentro de Visual Studio Code en Windows 10, Windows 11, Linux y macOS.

Cuando se instala solo con este método, por defecto la CLI de PAC está disponible solo en un terminal de Visual Studio Code a menos que habilites la CLI de PAC en el terminal del símbolo del sistema (CMD) y en los terminales de PowerShell para Windows
Instalar con la herramienta .NET Windows, Linux, macOS Habilita el uso de comandos en un shell de PowerShell, CMD o Bash en Windows 10, Windows 11, Linux y macOS.

Este método de instalación no permite el uso de datos pac ni de ciertos comandos de paquete pac (deploy y show) que solo son accesibles en Windows.
Install con Windows MSI solo Windows Habilita el uso de comandos dentro de un terminal de PowerShell dentro de 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 (comando para mostrar el paquete)

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

Estos comandos no están disponibles en Windows si solo se instala con .NET Tool.

Comprobar si Power Platform CLI ya está instalado

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

  1. Abra una terminal de PowerShell:

    • Si SOLO ha instalado la extensión Visual Studio Code, abra una ventana de terminal de Visual Studio Code PowerShell.
    • Si ha instalado usando .NET Tool, abra una terminal en PowerShell de Visual Studio Code o una terminal de PowerShell.

  2. Escriba 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.

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 presione Enter.

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 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 tiene un par de parámetros útiles:

  • El parámetro le permite conectarse automáticamente al entorno correcto. Si omite el parámetro , está conectado al entorno predeterminado, pero con el parámetro 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 asegura que aún pueda conectarse. Por ejemplo, en GitHub Codespaces, el parámetro --deviceCode se agrega automáticamente al ejecutar pac auth create.

Ejemplo

Para conectarse al entorno , 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 enumera todos los perfiles de autenticación en su máquina. El comando selecciona un comando diferente.

Ejemplo

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

pac auth list

Al ejecutar el comando 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 completo 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 . 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 , use

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 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 o ; por ejemplo: .

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 la CLI de Microsoft Power Platform
Solucionar problemas de la CLI de Microsoft Power Platform
marco de componentes Power Apps

  • Last updated on