⏯️Primeros pasos

Instalar PowerShell Universal

Deberá instalar el servidor de PowerShell Universal. Hay muchas formas de hacerlo, pero puede usar la línea de comandos siguiente para empezar rápidamente:

Windows

Puede instalar PowerShell Universal como servicio. Asegúrese de que PowerShell se ejecute como administrador; de lo contrario, el servicio no se instalará correctamente.

Install-Module Devolutions.PowerShellUniversal
Install-PSUServer

Linux

Puede instalar PowerShell Universal mediante el siguiente script de shell:

Install-Module Devolutions.PowerShellUniversal
Install-PSUServer

Mac OS X

Puede instalar PowerShell Universal mediante el módulo de PowerShell Universal:

Install-Module Devolutions.PowerShellUniversal
Install-PSUServer -AddToPath
Start-PSUServer -Port 5000

Raspberry PI OS

wget https://imsreleases.blob.core.windows.net/universal/production/2.4.0/Universal.linux-arm.2.4.0.zip
unzip Universal.linux-arm.2.3.2.zip -d ./PSU
chmod +x ./PSU/Universal.Server
./PSU/Universal.Server

Abrir PowerShell Universal

De forma predeterminada, PowerShell Universal se ejecuta en el puerto 5000 de localhost. Abra un navegador web y navegue a http://localhost:5000.

Iniciar sesión con una Devolutions Account

La primera vez que navegue a PowerShell Universal, puede iniciar sesión con una Devolutions account para recibir una licencia de desarrollador gratuita. Esta licencia habilitará todas las funciones y está destinada a flujos de trabajo que no sean de producción.

Este flujo de licencia de desarrollador está destinado al desarrollo local y requiere acceso local al host de PowerShell Universal. Si los usuarios acceden a PSU únicamente desde navegadores remotos a través de Docker, IIS o un proxy inverso, deben utilizar en su lugar una de las rutas de licencia estándar.

Asistente de primera ejecución

Opcionalmente, puede optar por ejecutar la configuración del asistente de primera ejecución en lugar de iniciar sesión con una Devolutions account y proporcionar una clave de licencia.

Crear una API

Las API le permiten llamar a scripts de PowerShell a través de HTTP. Para crear una API, haga clic en API \ Endpoints y luego en Create New Endpoint. Especifique una URL. Desactive la autenticación para este endpoint.

A continuación, haga clic en details en su nueva API e introduzca el siguiente comando en el editor:

Get-ComputerInfo

Guarde el script y luego haga clic en el botón Execute para probarlo.

También puede ejecutar la API mediante Invoke-RestMethod.

PS C:\Users\adamr> Invoke-RestMethod http://localhost:5000/hello-world

WindowsBuildLabEx                                       : 22000.1.amd64fre.co_release.210604-1628
WindowsCurrentVersion                                   : 6.3
WindowsEditionId                                        : Professional
WindowsInstallationType                                 : Client
WindowsInstallDateFromRegistry                          : 8/6/2021 4:05:12 PM
WindowsProductId                                        : 00330-52452-93139-AAOEM
WindowsProductName                                      : Windows 10 Pro
WindowsRegisteredOrganization                           :

Crear un script

Para crear un script, haga clic en Automation \ Scripts y luego en Create New Script.

Introduzca el siguiente script en el editor y guarde:

Read-Host "What should I say?"

1..100 | ForEach-Object {
    Write-Progress -PercentComplete $_ -Activity "Processing..."
}

Get-Service

Una vez guardado el script, haga clic en Run.

Crear una app

Para crear una nueva interfaz de usuario basada en PowerShell (app), puede hacer clic en User Interfaces \ Apps y luego en Create New App.

Después de hacer clic en Ok, haga clic en el botón Details para editar el script de PowerShell. Añada el siguiente script al editor:

New-UDApp -Title "Hello, World!" -Content {
    New-UDButton -Text "Click Me" -OnClick {
        Show-UDToast -Message 'Success!!'
    }
}

Guarde la app, haga clic en el botón Restart y luego en el botón View. Haga clic en el botón Click Me.

Más información sobre las distintas funciones de PowerShell Universal:

• API
• Automatización
• Apps

Véase también

• Devolutions Academy – Instalación