> 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

{% hint style="info" %}
Les traductions nécessitent une [licence](https://ironmansoftware.com/pricing/powershell-universal).
{% endhint %}

La prise en charge des traductions offre la possibilité d'utiliser un fournisseur spécial pour retourner des chaînes de caractères en fonction de la langue de l'utilisateur accédant à l'API ou au tableau de bord.

## Définir des chaînes de caractères

Naviguez vers Platform \ Translations dans la console d'administration pour définir les chaînes de langue.

![](/files/iz3fxjxLQYFbATBf64ay)

Pour définir une nouvelle langue, cliquez sur Create New Language Translation. L'identifiant de langue doit être l'[identifiant de langue](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) que le navigateur présentera lorsqu'un utilisateur accède à l'API ou au tableau de bord (ex. `en-US`)

![](/files/u5G8JQsdy2aUI5SuDUfS)

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

![](/files/puOyPVWK7qbmZ3kDxuEJ)

## Utiliser des chaînes de caractères

Pour utiliser une chaîne de caractères, vous tirerez parti du nouveau fournisseur `$tl:`. L'utilisation de ce fournisseur dans vos scripts traduira automatiquement la clé vers 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 la langue de l'utilisateur est `en`, sera `USA`.

Les chaînes de caractères sont actuellement disponibles automatiquement dans les API et les tableaux de bord, ainsi que dans les scripts lors de la définition de la variable `LanguageID`.

{% 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 vous suggérons d'utiliser le fournisseur `$tl:` à la place. Le fournisseur `$t:` sera mappé sur les machines qui ne disposent pas déjà d'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` dans la requête HTTP lorsque les utilisateurs visitent la page du tableau de bord ou effectuent un appel API. Si vous souhaitez définir une langue lors de l'exécution d'un script, vous devrez définir la variable `$LanguageID` sur la langue que vous souhaitez retourner.

### Logique de repli

Si une langue n'est pas définie pour l'identifiant de langue spécifique (ex. `en-US`), PowerShell Universal tentera de localiser la prochaine langue la plus appropriée. 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é. Vous pouvez spécifier cette langue de repli dans Settings \ General \ Platform.

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 au sein du référentiel. Chaque langue disposera d'un fichier `.ps1` nommé d'après l'identifiant de langue. `New-PSUTranslation` est utilisé pour définir la langue et définir les chaînes de caractères.

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.

![](/files/pim3rLBpPA4LXA2w8wqT)


---

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

```
GET https://docs.devolutions.net/powershell-universal/fr/plateforme/translations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.