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

# Übersetzungen

{% hint style="info" %}
Übersetzungen erfordern eine [Lizenz](https://store.devolutions.net/package#psu).
{% endhint %}

Die Übersetzungsunterstützung bietet die Möglichkeit, einen speziellen Provider zu verwenden, um Strings basierend auf der Sprache des Benutzers zurückzugeben, der auf die API oder das Dashboard zugreift.

## Strings definieren

Navigieren Sie in der Admin-Konsole zu Platform \ Translations, um Sprach-Strings zu definieren.

![](/files/s0CtThwygsxvVpb1Nnfa)

Um eine neue Sprache zu definieren, klicken Sie auf Create New Language Translation. Die Sprach-ID sollte die [Sprach-ID ](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)sein, die der Browser präsentiert, wenn ein Benutzer auf die API oder das Dashboard zugreift (z. B. `en-US`)

![](/files/zbKQAH9mFmiBzOUjPHfr)

Sobald Sie die Sprache erstellt haben, können Sie damit beginnen, ihr Strings hinzuzufügen, indem Sie auf Edit klicken. Der Key wird in Ihren Skripten verwendet und gibt den Wert zurück. Der Wert ändert sich je nach Sprache.

![](/files/840mUePqswtgmHLKrqoY)

## Strings verwenden

Um einen String zu verwenden, nutzen Sie den neuen `$tl:`-Provider. Wenn Sie diesen Provider in Ihren Skripten verwenden, wird der Key automatisch in den String für die Sprache des Benutzers übersetzt.

Beispielsweise würden Sie die Variable folgendermaßen verwenden.

```powershell
$tl:String1
```

Der zurückgegebene Wert ist `USA`, wenn die Locale des Benutzers en ist.

Strings sind derzeit automatisch in APIs und Dashboards verfügbar sowie in Skripten, wenn die Variable `LanguageID` gesetzt wird.

{% hint style="warning" %}
Beachten Sie, dass der `$t:`-Provider ebenfalls verfügbar ist, wir aber aufgrund von Konflikten mit dem FileSystem-Provider und zugeordneten T:-Laufwerken empfehlen, stattdessen den `$tl:`-Provider zu verwenden. Der `$t:`-Provider wird auf Computern zugeordnet, auf denen noch kein T:-Laufwerk zugeordnet ist.
{% endhint %}

## Eine Sprache auswählen

PowerShell Universal wählt die Sprache des Benutzers aus, indem es den `Accept-Language`-Header in der HTTP-Anfrage untersucht, wenn Benutzer die Dashboard-Seite besuchen oder einen API-Aufruf durchführen. Wenn Sie beim Ausführen eines Skripts eine Sprache festlegen möchten, müssen Sie die Variable `$LanguageID` auf die Sprache setzen, die Sie zurückgeben möchten.

### Fallback-Logik

Wenn für die spezifische Sprach-ID (z. B. `en-US`) keine Sprache definiert ist, versucht PowerShell Universal, die nächstbeste Sprache zu finden. In diesem Beispiel würde dann nach `en` gesucht.

Wenn keine Sprache gefunden werden kann, wird die serverweite Fallback-Sprache verwendet. Wenn diese nicht definiert wurde, wird `en` verwendet. Sie können diese Fallback-Sprache unter Settings \ General \ Platform angeben.

Wenn für den angegebenen Key keine Sprache gefunden werden kann, wird der Key zurückgegeben.

## Sprachdateien

Sprachdateien werden im Ordner translations innerhalb des Repositorys erzeugt. Jede Sprache verfügt über eine `.ps1`-Datei, die nach der Sprach-ID benannt ist. `New-PSUTranslation` wird verwendet, um die Sprache zu definieren und die Strings festzulegen.

Es kann wünschenswert sein, Sprachdateien auf diese Weise zu bearbeiten, um das Kopieren und Einfügen von Keys zwischen Sprachdateien zu ermöglichen.

![](/files/TpRwVcEXJc3NXs6PjuuG)


---

# 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/de/plattform/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.