> 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

Konfigurieren Sie Sprachübersetzungen in PowerShell Universal, um lokalisierte Zeichenfolgen in APIs und Dashboards basierend auf dem Browser-Gebietsschema jedes Benutzers bereitzustellen.

{% 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 Zeichenfolgen basierend auf der Sprache des Benutzers zurückzugeben, der auf die API oder das Dashboard zugreift.

## Zeichenfolgen definieren

Navigieren Sie in der Admin Console zu **Einstellungs-Zahnrad > Übersetzungen**, um Sprachzeichenfolgen zu definieren.

Um eine neue Sprache zu definieren, klicken Sie auf Create New Language Translation. Die Sprach-ID sollte die Sprach-ID sein, die der Browser präsentiert, wenn ein Benutzer auf die API oder das Dashboard zugreift (z. B. `en-US`).

Sobald Sie die Sprache erstellt haben, können Sie mit dem Hinzufügen von Zeichenfolgen beginnen, 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.

## Zeichenfolgen verwenden

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

Sie würden die Variable beispielsweise wie folgt verwenden.

```powershell
$tl:String1
```

Der zurückgegebene Wert ist `USA`, wenn das Gebietsschema des Benutzers en ist.

Zeichenfolgen 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, aber aufgrund von Konflikten mit dem FileSystem-Provider und zugeordneten T:-Laufwerken empfehlen wir, stattdessen den `$tl:`-Provider zu verwenden. Der `$t:`-Provider wird auf Computern zugeordnet, auf denen nicht bereits ein 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 Fall würde beispielsweise 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 die Fallback-Sprache unter **Einstellungs-Zahnrad > General** 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 generiert. 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 Zeichenfolgen 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.


---

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