⬇️Instalación

Instalación MSI (Windows)

La instalación MSI crea un servicio PowerShell Universal. De forma predeterminada, PowerShell Universal escucha en el puerto 5000. Puede navegar a http://localhost:5000

Las descargas MSI están disponibles en nuestra página de descargas.

Las instalaciones de sistema se ejecutan como un servicio de Windows. Las instalaciones de usuario se ejecutan cuando el usuario inicia sesión en la máquina. La instalación de usuario se ejecuta en el contexto del usuario.

Parámetros MSI

La siguiente tabla contiene los parámetros que puede especificar si ejecuta msiexec contra nuestra instalación MSI con fines de automatización:

Parámetro	Descripción	Valor predeterminado
INSTALLFOLDER	La carpeta de instalación de PowerShell Universal	%ProgramFiles(x86)%\Universal
TCPPORT	El puerto TCP en el que escuchará el servidor HTTP.	5000
REPOFOLDER	La carpeta del repositorio en la que se guardarán los ficheros de configuración.	%ProgramData%\UniversalAutomation\Repository
CONNECTIONSTRING	La cadena de conexión de SQL, SQLite o PostgreSQL.	Data Source=%ProgramData%\UniversalAutomation\database.db
DATABASETYPE	SQL, SQLite o PostgreSQL	SQLite
STARTSERVICE	Si se debe iniciar el servicio después de la instalación (0 o 1)	1
SERVICEACCOUNT	La cuenta de servicio que se debe establecer para el servicio de Windows. Utilice el formato dominio\nombredeusuario.	Ninguno
SERVICEACCOUNTPASSWORD	La contraseña de la cuenta de servicio que se debe establecer para el servicio de Windows. La contraseña se enmascarará con *** en el registro del instalador.	Ninguno
TELEMETRY	Recopilación anónima de telemetría	0
ADDPSMODULEPATH	Añade el directorio del módulo de PowerShell Universal a la variable de entorno PSModulePath.	1
STARTSERVICE	Si se debe iniciar el servicio después de la instalación.	1
INSTALLTYPE	Si se debe realizar una instalación de servidor o de usuario.	Servidor

Ejemplo

El ejemplo siguiente muestra cómo ejecutar msiexec.exe para instalar PowerShell Universal y proporcionar parámetros al instalador:

 Start-Process msiexec.exe -ArgumentList "/I C:\Users\adamr\Downloads\PowerShellUniversal.5.5.2.msi /q /norestart /L*V `"C:\users\adamr\desktop\msi.log.txt`" STARTSERVICE=0 SERVICEACCOUNT=contoso\service_account SERVICEACCOUNTPASSWORD=ThisPasswordWillBeReplacedWithAsterisksInTheMSILogs" -Wait -NoNewWindow

Instalación ZIP

También puede descargar el ZIP desde nuestra página de descargas si desea desplegar los ficheros con xcopy en Windows o Linux.

Windows

Puede iniciar Universal descomprimiendo el contenido, desbloqueando los ficheros y ejecutando después Universal.Server.exe.

Expand-Archive -Path .\Universal.zip -DestinationPath .\Universal
Get-ChildItem .\Universal -Recurse | Unblock-File
Start-Process .\Universal\Universal.Server.exe

Linux

Descargue el paquete ZIP para Linux desde la página de descargas y, a continuación, utilice la siguiente línea de comandos para instalar e iniciar PowerShell Universal:

 sudo apt install unzip 
 unzip psu.zip -d PSU
 chmod +x ./PSU/Universal.Server
 ./PSU/Universal.Server

Servicio de Linux

Puede utilizar systemd para iniciar PowerShell Universal como un servicio. El script siguiente es un ejemplo de descarga de una versión de PowerShell Universal y su instalación como servicio:

# ----
# This script will install PowerShell Universal on Linux as a service
# This has been tested on Ubuntu 20.04 (ARM64) on a Raspberry Pi 4
# ----
# Dependencies:
# wget
# unzip
#
# Make sure they are installed
# ----

# These are used to derive the download URL
PSU_VERSION="5.5.2" # Change this to the current version
PSU_ARCH="arm64" # Change this to your desired architecture
PSU_FILE="Universal.linux-${PSU_ARCH}.${PSU_VERSION}.zip"
PSU_URL="https://imsreleases.blob.core.windows.net/universal/production/${PSU_VERSION}/${PSU_FILE}"

# These are used for installing PowerShell Universal
# If you'd like to use a different path, change this
PSU_PATH="/opt/psuniversal"
PSU_EXEC="${PSU_PATH}/Universal.Server"

# These are for installing it as a service
PSU_SERVICE="psuniversal"
PSU_USER="psuniversal"

# ----
# BEGIN
# ----

echo "Creating $PSU_PATH and granting access to $USER"
sudo mkdir $PSU_PATH
sudo setfacl -m "u:${USER}:rwx" $PSU_PATH

echo "Creating user $PSU_USER and making it the owner of $PSU_PATH"
sudo useradd $PSU_USER -m
sudo chown $PSU_USER -R $PSU_PATH

echo "Downloading PowerShell Universal $PSU_VERSION ($PSU_ARCH)"
wget -q $PSU_URL -O $PSU_FILE

echo "Extracting $PSU_FILE to $PSU_PATH"
unzip -o -qq $PSU_FILE -d $PSU_PATH

echo "Make $PSU_EXEC executable"
sudo chmod +x $PSU_EXEC

echo "Creating service configuration"
cat <<EOF > ~/$PSU_SERVICE.service
[Unit]
Description=PowerShell Universal
[Service]
ExecStart=$PSU_EXEC
SyslogIdentifier=psuniversal
User=$PSU_USER
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF

echo "Creating and starting service"
sudo cp -f ~/$PSU_SERVICE.service /etc/systemd/system
sudo systemctl daemon-reload
sudo systemctl enable $PSU_SERVICE
sudo systemctl start $PSU_SERVICE
sudo systemctl status $PSU_SERVICE --no-pager

# If you don't use UFW, you can comment this out
echo "Allow port 5000/tcp"
sudo ufw allow 5000/tcp

# ----
# END
# ----

Módulo de PowerShell

Puede utilizar el módulo de PowerShell de PowerShell Universal para instalar el servidor Universal. Para instalar el módulo, utilice Install-Module.

Install-Module Devolutions.PowerShellUniversal

Para instalar el servidor Universal, puede utilizar Install-PSUServer.

Install-PSUServer -LatestVersion

Al ejecutar este comando en Windows se crea e inicia un servicio de Windows en su máquina. Al ejecutar este comando en Linux se crea e inicia un servicio systemd en su máquina. Al ejecutar este comando en Mac OS se descarga y extrae el servidor PowerShell Universal.

Docker

Consulte la página de Docker.

Instalación en IIS

Visite la documentación de alojamiento en IIS para obtener información sobre cómo configurar PowerShell Universal como un sitio web de IIS.

Configuración del antivirus

PowerShell Universal aprovecha al máximo PowerShell y el SDK de PowerShell. Incluye scripts de PowerShell directamente en el producto. Considere configurar el antivirus para permitir la ejecución de scripts de PowerShell en PowerShell Universal.

Directorios

Los siguientes directorios contienen ejemplos, de un sistema Windows estándar, de scripts y ficheros ejecutables que puede que necesite excluir de las comprobaciones del antivirus. Cambiar las rutas en appsettings.json o en el instalador requiere cambiar los directorios que se excluyen.

Ruta	Descripción
%ProgramData%\PowerShellUniversal	Contiene los ficheros de registro y appsettings.json
%ProgramData%\UniversalAutomation	Contiene scripts de PowerShell y artefactos. Contiene la base de datos de fichero único cuando no se utiliza la integración con SQL.
%ProgramFiles(x86)\Universal	Contiene los ejecutables, bibliotecas y módulos de la aplicación PowerShell Universal.

Ejecutables

Puede que sea necesario excluir determinados ejecutables que ejecutan scripts de PowerShell. A continuación se muestra una lista de ejecutables que ejecutan PowerShell desde PowerShell Universal.

Nombre	Descripción
Universal.Server.exe	El servicio principal de PowerShell Universal.
PowerShellUniversal.Host.exe	El ejecutable del entorno host de PowerShell Universal.
pwsh.exe	PowerShell 7.x
PowerShell.exe	PowerShell 5.x

Nombre y contraseña de administrador predeterminados

Puede utilizar las variables de entorno $ENV:PSUDefaultAdminName y $ENV:PSUDefaultAdminPassword para cambiar este comportamiento. Estos valores solo se utilizan si no existe ya una cuenta de administrador. Esto resulta útil para instalaciones basadas en la nube.

Agente

El agente de PowerShell Universal ejecuta acciones de Event Hub. Instálelo según su entorno:

Windows (MSI)

El MSI del agente de PowerShell Universal está en nuestra página de descargas. Después de instalar el MSI, se ejecuta en su máquina un servicio del agente de PowerShell Universal. Configúrelo para que se conecte a PowerShell Universal.

ZIP

Los ficheros ZIP para cada plataforma que admitimos están en nuestra página de descargas. Cada ZIP contiene un fichero PSUAgent.exe o PSUAgent que puede iniciar un agente. Ejecute el proceso como un servicio para que se inicie cada vez que la máquina se reinicie.

Docker

La imagen de contenedor devolutions/powershell-universal-agent:latest proporciona el agente de PowerShell Universal como un contenedor de Docker para Linux.

docker pull devolutions/powershell-universal-agent:latest

Próximos pasos

En este punto, Universal está en funcionamiento. Visite http://localhost:5000 o su puerto predeterminado para navegar a la consola de administración. Inicie sesión con el nombre y la contraseña de administrador predeterminados o cree una cuenta de administrador predeterminada.

Véase también

• Devolutions Academy – Instalación