Übersetzungen

Übersetzungen erfordern eine Lizenz.

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.

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

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.

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

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.

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.