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

# Traductions

Configurez les traductions linguistiques dans PowerShell Universal pour fournir des chaînes localisées dans les API et les tableaux de bord selon les paramètres régionaux du navigateur de chaque utili

{% hint style="info" %}
Les traductions nécessitent une [licence](https://store.devolutions.net/package#psu).
{% endhint %}

La prise en charge des traductions permet d'utiliser un fournisseur spécial pour retourner des chaînes selon la langue de l'utilisateur qui accède à l'API ou au tableau de bord.

## Définir des chaînes

Accédez à **engrenage Paramètres > Traductions** dans la console d'administration pour définir les chaînes de langue.

Pour définir une nouvelle langue, cliquez sur Créer une nouvelle traduction de langue. L'ID de langue doit correspondre à l'ID de langue que le navigateur présentera lorsqu'un utilisateur accédera à l'API ou au tableau de bord (p. ex. `en-US`).

Une fois la langue créée, vous pouvez commencer à y ajouter des chaînes en cliquant sur Modifier. La clé sera utilisée dans vos scripts et retournera la valeur. La valeur changera selon la langue.

## Utiliser les chaînes

Pour utiliser une chaîne, vous tirerez parti du nouveau fournisseur `$tl:`. L'utilisation de ce fournisseur dans vos scripts traduira automatiquement la clé en la chaîne correspondant à la langue de l'utilisateur.

Par exemple, vous utiliseriez la variable de cette façon.

```powershell
$tl:String1
```

La valeur retournée, lorsque les paramètres régionaux de l'utilisateur sont en, sera `USA`.

Les chaînes sont actuellement disponibles automatiquement dans les API et les tableaux de bord, et dans les scripts lorsque la variable `LanguageID` est définie.

{% hint style="warning" %}
Notez que le fournisseur `$t:` est également disponible, mais en raison de conflits avec le fournisseur FileSystem et les lecteurs T: mappés, nous suggérons d'utiliser plutôt le fournisseur `$tl:`. Le fournisseur `$t:` sera mappé sur les machines qui n'ont pas déjà un lecteur T: mappé.
{% endhint %}

## Sélectionner une langue

PowerShell Universal sélectionne la langue de l'utilisateur en examinant l'en-tête `Accept-Language` de la requête HTTP lorsque l'utilisateur visite la page du tableau de bord ou effectue un appel d'API. Si vous souhaitez définir une langue lors de l'exécution d'un script, vous devrez définir la variable `$LanguageID` avec la langue que vous souhaitez retourner.

### Logique de repli

Si aucune langue n'est définie pour l'ID de langue spécifique (p. ex. `en-US`), PowerShell Universal tentera de trouver la meilleure langue suivante. Par exemple, il rechercherait alors `en`.

Si aucune langue ne peut être trouvée, la langue de repli à l'échelle du serveur sera utilisée. Si celle-ci n'a pas été définie, `en` sera utilisée. Vous pouvez spécifier la langue de repli sous **engrenage Paramètres > Général**.

Si aucune langue ne peut être trouvée pour la clé spécifiée, la clé sera retournée.

## Fichiers de langue

Les fichiers de langue sont générés dans le dossier translations à l'intérieur du dépôt. Chaque langue aura un fichier `.ps1` nommé d'après l'ID de langue. `New-PSUTranslation` est utilisé pour définir la langue et définir les chaînes.

Il peut être souhaitable de modifier les fichiers de langue de cette façon pour faciliter le copier-coller des clés entre les fichiers de langue.


---

# 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/fr/plateforme/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.