> 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/comandos-de-powershell/set-psuenvironment.md).

# Set-PSUEnvironment

Set-PSUEnvironment actualiza un entorno de ejecución existente en PowerShell Universal, identificado por un Id o un objeto de canalización.

## SINOPSIS

Actualiza un entorno de ejecución existente.

## SINTAXIS

```powershell
Set-PSUEnvironment -Id <Int64> [-Name <String>] [-Path <String>] [-Arguments <String>] [-Type <EnvironmentType>] [-PowerShellVersion <String>] [-Virtual] [-ContainerImageUrl <String>] [-ContainerImageTag <String>] [-ContainerPull] [-RunspaceSaturationWarningThresholdPercent <Int32>] [-RunspaceSaturationWarningDurationSeconds <Int32>] [<ConnectionOptions>] [<CommonParameters>]
Set-PSUEnvironment -Environment <ExecutionEnvironment> [-Name <String>] [-Path <String>] [-Arguments <String>] [-Type <EnvironmentType>] [-PowerShellVersion <String>] [-Virtual] [-ContainerImageUrl <String>] [-ContainerImageTag <String>] [-ContainerPull] [-RunspaceSaturationWarningThresholdPercent <Int32>] [-RunspaceSaturationWarningDurationSeconds <Int32>] [<ConnectionOptions>] [<CommonParameters>]
```

`<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`.

## DESCRIPCIÓN

Actualiza un entorno por Id o por objeto de canalización. Solo cambian los campos indicados. `-Name` y `-Path`, cuando se especifican, no deben estar vacíos. Para `-Type Isolated`, `-PowerShellVersion` acepta versiones instaladas o selectores multi-pwsh (`stable`, `preview`, `lts` o una versión principal.secundaria); utilice `-Virtual` para un entorno virtual multi-pwsh administrado. Para los entornos de contenedor, establezca la URL y la etiqueta de la imagen y active o desactive la extracción de la imagen con `-ContainerPull`.

## EJEMPLOS

```powershell
Set-PSUEnvironment -Id 3 -Name 'PowerShell 7' -Path 'C:\Program Files\PowerShell\7\pwsh.exe'
Set-PSUEnvironment -Id 3 -Type Isolated -PowerShellVersion stable -Virtual
```

## PARÁMETROS

| Parámetro                                    | Descripción                                                                               |
| -------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `-Id`                                        | Id numérico del entorno que se actualiza.                                                 |
| `-Environment`                               | Objeto de entorno que se actualiza; acepta la entrada de la canalización.                 |
| `-Name`                                      | Nuevo nombre de entorno no vacío.                                                         |
| `-Path`                                      | Nueva ruta de ejecutable no vacía.                                                        |
| `-Arguments`                                 | Nuevos argumentos de proceso.                                                             |
| `-Type`                                      | Tipo de entorno (`Custom`, `WindowsPowerShell`, `PowerShell7`, `Isolated` o `Container`). |
| `-PowerShellVersion`                         | Versión instalada o selector multi-pwsh para entornos aislados.                           |
| `-Virtual`                                   | Activa o desactiva el uso de un entorno virtual administrado.                             |
| `-ContainerImageUrl`                         | URL de la imagen de contenedor.                                                           |
| `-ContainerImageTag`                         | Etiqueta de la imagen de contenedor.                                                      |
| `-ContainerPull`                             | Activa o desactiva la extracción de la imagen de contenedor.                              |
| `-RunspaceSaturationWarningThresholdPercent` | Porcentaje del umbral de advertencia para los runspaces saturados.                        |
| `-RunspaceSaturationWarningDurationSeconds`  | Duración de la advertencia en segundos para los runspaces saturados.                      |
| `-ComputerName`                              | URL o nombre de host del servidor PSU de destino (alias `-Uri`).                          |
| `-AppToken`                                  | Token de aplicación de la API de administración.                                          |
| `-Credential`                                | Credenciales para la autenticación básica de la API de administración.                    |
| `-UseDefaultCredentials`                     | Usa las credenciales actuales de Windows.                                                 |
| `-Integrated`                                | Usa el cliente de administración en proceso.                                              |
| `-TrustCertificate`                          | Ignora los errores de validación del certificado.                                         |
| `-Cookies`                                   | Reutiliza las cookies de autenticación de la sesión.                                      |

## ENTRADAS

`PowerShellUniversal.ExecutionEnvironment`.

## PERMISOS

El token de acceso requiere `settings.environments/update` para ejecutar este cmdlet de forma remota.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/es/comandos-de-powershell/set-psuenvironment.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.