Import-LocalizedData

Import-LocalizedData [-BindingVariable] <string> [[-UICulture] <string>] [-BaseDirectory <string>] [-FileName <string>] [-SupportedCommand <string[]>] [<CommonParameters>]

C:\PS>import-localizeddata -bindingVariable messages

Beschreibung
-----------
Mit diesem Befehl werden Textzeichenfolgen in die Variable "$messages" importiert. Es werden alle Standardwerte für die Cmdlet-Parameter verwendet.

Wenn der Befehl im Skript "Archives.ps1" im Verzeichnis "C:\test" enthalten ist und der Wert der automatischen Variablen "$PsUICulture" "zh-CN" lautet, importiert Import-LocalizedData die Datei "Archives.psd1" in das Verzeichnis "C:\test\zh-CN".

C:\PS>import-localizeddata -bindingVariable msgTbl -uiculture ar-SA -filename Simple -baseDirectory C:\Data\Localized

Beschreibung
-----------
Mit diesem Befehl werden Textzeichenfolgen in die Variable "$msgTbl" eines Skripts importiert. 

Mit dem UICulture-Parameter wird festgelegt, dass das Cmdlet Daten aus der Datei "Simple.psd1" im Unterverzeichnis "ar-SA" von "C:\Data\Localized" importiert.

C:\PS># In C:\Test\en-US\test.psd1:

ConvertFrom-StringData @'
 # English strings
Msg1 = "The Name parameter is missing from the command."
Msg2 = "This command requires the credentials of a member of the Administrators group on the computer."
Msg3 = "Use $_ to represent the object that is being processed."
'@

# In C:\Test\Test.ps1

import-localizeddata -bindingvariable messages
write-host $messages.msg2

# In Windows PowerShell

C:\PS> .\test.ps1
This command requires the credentials of a member of the Administrators group on the computer.

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie lokalisierte Daten in einem einfachen Skript verwendet werden.

Im ersten Teil des Beispiels wird der Inhalt der Datei "Test.psd1" veranschaulicht. Sie enthält den Befehl "ConvertFrom-StringData", der eine Reihe von benannten Textzeichenfolgen in eine Hashtabelle konvertiert. Die Datei "test.psd1" befindet sich im Unterverzeichnis "en-US" des Verzeichnisses "C:\Test", das das Skript enthält.

Im zweiten Teil des Beispiels wird der Inhalt des Skripts "Test.ps1" veranschaulicht. Es enthält einen Befehl "Import-LocalizedData", mit dem die Daten aus der entsprechenden PSD1-Datei in die Variable "$Messages" importiert wird, und einen Befehl "Write-Host", mit dem eine der Meldungen in der Variablen "$Messages" in das Hostprogramm geschrieben wird.

Im letzten Teil des Beispiels wird das Skript ausgeführt. Die Ausgabe zeigt, dass die richtige Benutzermeldung in der für den aktuellen Benutzer des Betriebssystems festgelegten Benutzeroberflächensprache angezeigt wird.

C:\PS># In TestScript.ps1

$UserMessages = DATA {
    ConvertFrom-StringData @'
    # English strings
        Msg1 = "Enter a name."
        Msg2 = "Enter your employee ID."
        Msg3 = "Enter your building number."
'@ }

Import-LocalizedData -bindingVariable UserMessages

$UserMessages.Msg1
...

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie mit Import-LocalizedData im DATA-Abschnitt eines Skripts definierte Standardtextzeichenfolgen ersetzt werden.

In diesem Beispiel enthält der DATA-Abschnitt des Skripts "TestScript.ps1" einen Befehl "ConvertFrom-StringData", der den Inhalt des DATA-Abschnitts in eine Hashtabelle konvertiert und im Wert der Variablen "$UserMessages" speichert. 

Das Skript enthält zusätzlich den Befehl "Import-LocalizedData", mit dem eine Hashtabelle übersetzter Textzeichenfolgen aus der Datei "TestScript.psd1" in dem Unterverzeichnis importiert wird, das vom Wert der Variablen "$PsUICulture" angegeben wurde. Wenn die PSD1-Datei vom Befehl gefunden wird, werden die übersetzten Zeichenfolgen aus der Datei im Wert der gleichen Variablen "$UserMessages" gespeichert und die von der Logik des DATA-Abschnitts gespeicherte Hashtabelle überschrieben.

Im dritten Befehl wird die erste Meldung in der Variablen "$UserMessages" angezeigt.

Wenn mit dem Befehl "Import-LocalizedData" eine PSD1-Datei für die Sprache von "$PsUICulture" gefunden wird, enthält der Wert der Variablen "$UserMessages" die übersetzten Textzeichenfolgen. Falls der Befehl fehlschlägt, werden die im DATA-Abschnitt des Skripts definierten Standardtextzeichenfolgen angezeigt.

C:\PS># In Day1.ps1
Import-LocalizedData -bindingVariable Day
Day.MessageDate

# In Day2.ps1
Import-LocalizedData -bindingVariable Day -errorAction:silentlycontinue
Day.MessageDate

C:\PS> .\Day1.ps1

Import-LocalizedData : Cannot find PowerShell data file 'Day1.psd1' in directory 'C:\ps-test\fr-BE\' or any parent culture directories.
At C:\ps-test\Day1.ps1:17 char:21
+ Import-LocalizedData <<<<  Day
Today is Tuesday


C:\PS> .\Day2.ps1

Today is Tuesday

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie die Fehlermeldungen unterdrückt werden, die angezeigt werden, wenn Import-LocalizedData die Verzeichnisse nicht findet, die mit der Benutzeroberflächenkultur des Benutzers übereinstimmen, oder keine PSD1-Datei für das Skript in diesen Verzeichnissen findet.

Sie können den allgemeinen ErrorAction-Parameter mit dem Wert "SilentlyContinue" verwenden, um die Fehlermeldung zu unterdrücken. Dies ist besonders hilfreich, wenn Sie Benutzermeldungen in einer Standardsprache oder Ersatzsprache angegeben haben und keine Benutzermeldung erforderlich ist.

In diesem Beispiel werden die beiden Skripts "Day1.ps1" und Day2.ps1" verglichen, die den Befehl "Import-LocalizedData" enthalten. Der einzige Unterschied zwischen den Skripts besteht darin, dass in "Day2.ps1" der allgemeine ErrorAction-Parameter mit dem Wert "SilentlyContinue" verwendet wird.

In der Beispielausgabe werden die Ergebnisse gezeigt, wenn beide Skripts mit einer auf "fr-BE" festgelegten Benutzeroberflächenkultur ausgeführt werden und keine übereinstimmenden Dateien oder Verzeichnisse für diese Benutzeroberflächenkultur vorhanden sind. "Day1.ps1" zeigt eine Fehlermeldung und die englische Ausgabe an. "Day2.ps1" zeigt nur die englische Ausgabe an.