> 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

Configure las traducciones de idioma en PowerShell Universal para servir cadenas localizadas en API y paneles según la configuración regional del navegador de cada usuario.

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

La compatibilidad con traducciones permite utilizar un proveedor especial para devolver cadenas según el idioma del usuario que accede a la API o al panel.

## Definir cadenas

Vaya a **Engranaje de configuración > Traducciones** en la consola de administración para definir las cadenas de idioma.

Para definir un nuevo idioma, haga clic en Crear nueva traducción de idioma. El ID de idioma debe ser el ID de idioma que el navegador presentará cuando un usuario acceda a la API o al panel (por ejemplo, `en-US`).

Una vez 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.

## Usar cadenas

Para usar una cadena, aprovechará el nuevo proveedor `$tl:`. Al usar 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 forma.

```powershell
$tl:String1
```

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

Actualmente, las cadenas están disponibles automáticamente en API 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 %}

## Seleccionar 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 desea devolver.

### Lógica de reserva

Si no hay un idioma definido para el ID de idioma específico (por ejemplo, `en-US`), PowerShell Universal intentará localizar el siguiente idioma más adecuado. Por ejemplo, entonces buscaría `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 el idioma de reserva en **Engranaje de configuración > General**.

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 que resulte conveniente editar los ficheros de idioma de esta forma para facilitar copiar y pegar claves entre ficheros de idioma.


---

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