> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/es/getting-started.md). # Instalación Instale PowerShell Universal mediante el MSI, el ZIP o el módulo de PowerShell en Windows y Linux, incluidas las exclusiones de antivirus y las credenciales de administrador predeterminadas. PowerShell Universal admite instalaciones con MSI de Windows, ZIP, módulo de PowerShell, Docker, IIS y servicio de Linux. Elija el método que se ajuste a su entorno de alojamiento. ### Véase también * [Devolutions Academy – Instalación](https://academy.devolutions.net/student/activity/3465938-installation) ## Instalación con MSI (Windows) La instalación con MSI crea un servicio de PowerShell Universal. De forma predeterminada, PowerShell Universal escucha en el puerto 5000. Puede navegar a `http://localhost:5000` Las descargas del MSI están disponibles en nuestra [página de descargas](https://devolutions.net/download-center/powershell-universal/). 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 del MSI Utilice argumentos `PROPERTY=value` en mayúsculas con `msiexec`. Los valores predeterminados que figuran a continuación se aplican a una nueva instalación para todo el equipo, salvo que se indique un valor predeterminado por usuario. | Parámetro | Descripción | Valor predeterminado | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `INSTALLFOLDER` | Carpeta donde se instala PowerShell Universal. | Equipo: `%ProgramFiles%\Universal`; por usuario: `%LocalAppData%\Programs\PowerShellUniversal` | | `MSIINSTALLPERUSER` | Ámbito de instalación. Establezca `1` para una instalación por usuario; establezca `0` para una instalación para todo el equipo. | `0` | | `TCPPORT` | Puerto HTTP del servidor. | `5000` | | `HTTPSPORT` | Puerto HTTPS cuando `DEVCERT=1`. | `5001` | | `DEVCERT` | Crea e instala un certificado de desarrollo de localhost y habilita el punto de conexión HTTPS. Está deshabilitado para las instalaciones por usuario. | Equipo: `1`; por usuario: `0` | | `REPOFOLDER` | Carpeta de repositorio para los ficheros de configuración de PowerShell Universal. | Equipo: `%ProgramData%\UniversalAutomation\Repository`; por usuario: `%LocalAppData%\PowerShellUniversal\Repository` | | `CONNECTIONSTRING` | Cadena de conexión del proveedor de persistencia seleccionado. | Equipo: `Data Source=%ProgramData%\UniversalAutomation\database.db`; por usuario: `Data Source=%LocalAppData%\PowerShellUniversal\database.db` | | `DATABASETYPE` | Proveedor de persistencia. Los valores válidos son `SQLite`, `PostgreSQL` y `Microsoft SQL Server`. | `SQLite` | | `APPSETTINGSPATH` | Ruta donde el instalador escribe `appsettings.json` cuando aún no existe. | Equipo: `%ProgramData%\PowerShellUniversal\appsettings.json`; por usuario: `%LocalAppData%\PowerShellUniversal\appsettings.json` | | `INSTALLTYPE` | Establece el valor `Mode` escrito en `appsettings.json`. `Desktop` escribe el modo Desktop; cualquier otro valor escribe el modo Server. | `Server` | | `STARTSERVICE` | Inicia el servicio de Windows de PowerShell Universal después de la instalación. Esto no se aplica a las instalaciones por usuario porque no instalan un servicio de Windows. | Equipo: `1`; por usuario: `0` | | `SERVICEACCOUNT` | Cuenta de servicio de Windows completamente cualificada, como `CONTOSO\psu_svc`. Déjelo en blanco para ejecutarse como Sistema local. Solo para instalaciones para todo el equipo. | Vacío (Sistema local) | | `SERVICEACCOUNTPASSWORD` | Contraseña de `SERVICEACCOUNT`. El instalador enmascara este valor en su registro. Solo para instalaciones para todo el equipo. | Vacío | | `OPENBROWSER` | Abre la interfaz web después de que el servicio de Windows se inicie correctamente. Solo para instalaciones para todo el equipo. | `1` | | `ADDPSMODULEPATH` | Añade el directorio del módulo de PowerShell Universal a `PSModulePath`. | `1` | | `TELEMETRY` | Habilita la recopilación de telemetría anónima. | `1` | | `STARTUPSHORTCUT` | Crea un acceso directo de inicio para una instalación por usuario. | Por usuario: `1` | ### Ejemplo El ejemplo siguiente ejecuta una instalación MSI silenciosa para todo el equipo sin iniciar el servicio. Los valores de cuenta y contraseña son solo ejemplos. {% code overflow="wrap" %} ```powershell Start-Process msiexec.exe -ArgumentList '/i "C:\Installers\PowerShellUniversal.msi" /q /norestart /L*V "C:\Logs\powershell-universal-msi.log" MSIINSTALLPERUSER=0 STARTSERVICE=0 SERVICEACCOUNT=CONTOSO\psu_svc SERVICEACCOUNTPASSWORD=ReplaceWithASecurePassword' -Wait -NoNewWindow ``` {% endcode %} ## Instalación con ZIP También puede descargar el ZIP desde nuestra [página de descargas](https://devolutions.net/download-center/powershell-universal/) si desea implementar los ficheros mediante xcopy en Windows o Linux. ### Windows Puede iniciar Universal descomprimiendo el contenido, desbloqueando los ficheros y ejecutando después `Universal.Server.exe`. ```powershell Expand-Archive -Path .\Universal.zip -DestinationPath .\Universal Get-ChildItem .\Universal -Recurse | Unblock-File Start-Process .\Universal\Universal.Server.exe ``` ### Linux Puede utilizar la siguiente línea de comandos en Linux para instalar e iniciar PowerShell Universal: ```bash wget -O psu.zip https://cdn.devolutions.net/download/Devolutions.PowerShellUniversal.linux-x64.2026.3.0.0.zip 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 servicio. El script siguiente es un ejemplo de descarga de una versión de PowerShell Universal y de su instalación como servicio: ```bash # ---- # 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="2026.3.0.0" # Change this to the desired version PSU_ARCH="arm64" # Change this to your desired architecture PSU_FILE="Devolutions.PowerShellUniversal.linux-${PSU_ARCH}.${PSU_VERSION}.zip" PSU_URL="https://cdn.devolutions.net/download/${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 files 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 < ~/$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`. ```powershell Install-Module Devolutions.PowerShellUniversal ``` Para instalar el servidor Universal, puede utilizar `Install-PSUServer`. ```powershell 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 de 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 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 ser necesario excluir de las comprobaciones del antivirus. Cambiar las rutas en appsettings.json o en el instalador requiere cambiar qué directorios se excluyen. | Ruta | Descripción | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `%ProgramData%\PowerShellUniversal` | Contiene 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%\Universal` | Contiene los ejecutables, las bibliotecas y los 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 de 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 PowerShell Universal Agent ejecuta acciones del Event Hub. Instálelo según su entorno: ### Windows (MSI) El MSI del PowerShell Universal Agent está en nuestra página de descargas. Después de instalar el MSI, un servicio de PowerShell Universal Agent se ejecuta en su máquina. Configúrelo para que se conecte a PowerShell Universal. ### ZIP Los ficheros ZIP de 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 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 PowerShell Universal Agent como contenedor Docker de 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/es/getting-started.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.