> 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/plataforma/translations.md).

# Traducciones

{% hint style="info" %}
Las traducciones requieren una [licencia](https://store.devolutions.net/package#psu).
{% endhint %}

La compatibilidad con traducciones ofrece la posibilidad de utilizar un proveedor especial para devolver cadenas basadas en el idioma del usuario que accede a la API o al panel.

## Definición de cadenas

Vaya a Plataforma \ Traducciones en la Admin Console para definir cadenas de idioma.

![](/files/cMfmtzhT8iGo4Bb5wulv)

Para definir un nuevo idioma, haga clic en Crear nueva traducción de idioma. El ID de idioma debe ser el [ID de idioma ](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)que el navegador presentará cuando un usuario acceda a la API o al panel (p. ej., `en-US`)

![](/files/daQlt7A8kNxT0UpKWfBu)

Una vez que haya creado el idioma, puede empezar a añadirle cadenas haciendo clic en Editar. La clave se utilizará dentro de sus scripts y devolverá el valor. El valor cambiará según el idioma.

![](/files/yt7ooXFH9nKpq2Gj6OVE)

## Uso de cadenas

Para utilizar una cadena, aprovechará el nuevo proveedor `$tl:`. Al utilizar este proveedor en sus scripts, la clave se traducirá automáticamente a la cadena correspondiente al idioma del usuario.

Por ejemplo, usaría la variable de esta manera.

```powershell
$tl:String1
```

El valor devuelto, cuando la configuración regional del usuario sea en, será `USA`.

Las cadenas están disponibles actualmente de forma automática en APIs y paneles, y en scripts al establecer la variable `LanguageID`.

{% hint style="warning" %}
Tenga en cuenta que el proveedor `$t:` también está disponible, pero debido a conflictos con el proveedor FileSystem y las unidades T: asignadas, sugerimos utilizar el proveedor `$tl:` en su lugar. El proveedor `$t:` se asignará en máquinas que no tengan ya una unidad T: asignada.
{% endhint %}

## Selección de un idioma

PowerShell Universal selecciona el idioma del usuario examinando el encabezado `Accept-Language` de la solicitud HTTP cuando los usuarios visitan la página del panel o realizan una llamada a la API. Si desea establecer un idioma al ejecutar un script, deberá establecer la variable `$LanguageID` en el idioma que desee devolver.

### Lógica de reserva

Si no se ha definido un idioma para el ID de idioma específico (p. ej., `en-US`), PowerShell Universal intentará localizar el siguiente mejor idioma. Por ejemplo, buscaría entonces `en`.

Si no se encuentra ningún idioma, se utilizará el idioma de reserva de todo el servidor. Si no se ha definido, se utilizará `en`. Puede especificar este idioma de reserva en Configuración \ General \ Plataforma.

Si no se encuentra ningún idioma para la clave especificada, se devolverá la clave.

## Ficheros de idioma

Los ficheros de idioma se generan en la carpeta translations dentro del repositorio. Cada idioma tendrá un fichero `.ps1` con el nombre del ID de idioma. `New-PSUTranslation` se utiliza para definir el idioma y establecer las cadenas.

Puede resultar deseable editar los ficheros de idioma de esta manera para facilitar copiar y pegar claves entre ficheros de idioma.

![](/files/bcnkNvQHxIJzqQLitK8u)


---

# 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/plataforma/translations.md?ask=<question>&goal=<endgoal>
```

`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.