Import-LocalizedData

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

Das Cmdlet Import-LocalizedData ruft Zeichenfolgen dynamisch aus einem Unterverzeichnis ab, dessen Name der Benutzeroberflächensprache für den aktuellen Benutzer des Betriebssystems entspricht. Es wurde entwickelt, um Skripts zu ermöglichen, Benutzernachrichten in der Sprache der Benutzeroberfläche anzuzeigen, die vom aktuellen Benutzer ausgewählt wurde.

Import-LocalizedData Importiert Daten aus .psd1 Dateien in sprachspezifischen Unterverzeichnissen des Skriptverzeichnisses und speichert sie in einer lokalen Variablen, die im Befehl angegeben ist. Das Cmdlet wählt das Unterverzeichnis und die Datei basierend auf dem Wert der automatischen Variablen $PSUICulture aus. Wenn Sie die lokale Variable im Skript verwenden, um eine Benutzermeldung anzuzeigen, wird die Meldung in der Benutzeroberflächensprache angezeigt.

Sie können die Parameter von Import-LocalizedData verwenden, um eine alternative Benutzeroberflächenkultur, einen Pfad und einen Dateinamen anzugeben, unterstützte Befehle hinzuzufügen und die Fehlermeldung zu unterdrücken, die angezeigt wird, wenn die .psd1 Dateien nicht gefunden werden.

Das cmdlet Import-LocalizedData unterstützt die Skript-Internationalisierungsinitiative, die in Windows PowerShell 2.0 eingeführt wurde. Diese Initiative zielt darauf ab, Benutzer weltweit besser zu bedienen, indem skripts die Anzeige von Benutzermeldungen in der Benutzeroberflächensprache des aktuellen Benutzers erleichtert werden. Weitere Informationen hierzu und zum Format der .psd1-Dateien finden Sie unter about_Script_Internationalization.

In diesem Beispiel werden Textzeichenfolgen in die variable $Messages importiert. Es verwendet die Standardwerte aller anderen Cmdlet-Parameter.

Import-LocalizedData -BindingVariable "Messages"

Wenn der Befehl im skript Archives.ps1 im verzeichnis C:\Test enthalten ist und der Wert der automatischen variablen $PsUICulture zh-CNist, importiert Import-LocalizedData die Archives.psd1 Datei im verzeichnis C:\test\zh-CN in die variable $Messages.

Dieses Beispiel wird an der Befehlszeile ausgeführt, die sich nicht in einem Skript befindet. Sie ruft lokalisierte Datenzeichenfolgen aus der Datei Test.psd1 ab und zeigt sie in der Befehlszeile an. Da der Befehl nicht in einem Skript verwendet wird, ist der Parameter FileName erforderlich. Der Befehl verwendet den parameter UICulture, um die en-US Kultur anzugeben.

Import-LocalizedData -FileName "Test.psd1" -UICulture "en-US"

Name                           Value
----                           -----
Msg3                           "Use $_ to represent the object that is being processed."
Msg2                           "This command requires the credentials of a member of the Administrators group on the...
Msg1                           "The Name parameter is missing from the command."

Import-LocalizedData Gibt eine Hashtabelle zurück, die die lokalisierten Datenzeichenfolgen enthält.

Import-LocalizedData -BindingVariable "MsgTbl" -UICulture "ar-SA" -FileName "Simple" -BaseDirectory "C:\Data\Localized"

Mit diesem Befehl werden Textzeichenfolgen in die $MsgTbl Variable eines Skripts importiert.

Es verwendet den parameter UICulture, um das Cmdlet zum Importieren von Daten aus der Simple.psd1-Datei im Unterverzeichnis ar-SA von C:\Data\Localizedzu leiten.

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

PS C:\> # 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

PS C:\> .\Test.ps1

This command requires the credentials of a member of the Administrators group on the computer.

Der erste Teil des Beispiels zeigt den Inhalt der datei Test.psd1. Sie enthält einen ConvertFrom-StringData Befehl, der eine Reihe von benannten Textzeichenfolgen in eine Hashtabelle umwandelt. Die Test.psd1 Datei befindet sich im Unterverzeichnis en-US des C:\Test Verzeichnisses, das das Skript enthält.

Der zweite Teil des Beispiels zeigt den Inhalt des skripts Test.ps1. Sie enthält einen Import-LocalizedData-Befehl, der die Daten aus der übereinstimmenden .psd1 Datei in die $Messages Variable und einen Write-Host Befehl importiert, der eine der Nachrichten in der $Messages Variablen in das Hostprogramm schreibt.

Der letzte Teil des Beispiels führt das Skript aus. Die Ausgabe zeigt, dass die richtige Benutzermeldung in der Für den aktuellen Benutzer des Betriebssystems festgelegten Benutzersprache angezeigt wird.

In diesem Beispiel wird gezeigt, wie Sie Import-LocalizedData verwenden, um im DATA-Abschnitt eines Skripts definierte Standardtextzeichenfolgen zu ersetzen.

PS C:\> # 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...

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

Das Skript enthält auch einen Import-LocalizedData Befehl, der eine Hash-Tabelle mit übersetzten Textzeichenfolgen aus der Datei TestScript.psd1 in das Unterverzeichnis importiert, das durch den Wert der $PsUICulture Variablen angegeben wird. Wenn der Befehl die .psd1 Datei findet, speichert er die übersetzten Zeichenfolgen aus der Datei im Wert derselben $UserMessages Variablen und überschreibt die Hash-Tabelle, die von der Logik der DATA-Sektion gespeichert wurde.

Der dritte Befehl zeigt die erste Meldung in der variablen $UserMessages an.

Wenn der Befehl Import-LocalizedData eine .psd1 Datei für die $PsUICulture Sprache findet, enthält der Wert der variablen $UserMessages die übersetzten Textzeichenfolgen. Wenn der Befehl aus irgendeinem Grund fehlschlägt, zeigt der Befehl die im DATENabschnitt des Skripts definierten Standardtextzeichenfolgen an.

In diesem Beispiel wird gezeigt, wie die Fehlermeldungen unterdrückt werden, die angezeigt werden, wenn Import-LocalizedData die Verzeichnisse, die der Benutzeroberflächenkultur des Benutzers entsprechen, nicht gefunden werden können oder in diesen Verzeichnissen keine .psd1 Datei für das Skript gefunden werden kann.

PS C:\> # In Day1.ps1

Import-LocalizedData -BindingVariable "Day"

# In Day2.ps1

Import-LocalizedData -BindingVariable "Day" -ErrorAction:SilentlyContinue

PS C:\> .\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

PS C:\> .\Day2.ps1
Today is Tuesday

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

In diesem Beispiel werden zwei Skripts, Day1.ps1 und Day2.ps1, verglichen, die einen Import-LocalizedData Befehl enthalten. Die Skripts sind identisch, außer dass Day2 den ErrorAction gemeinsamen Parameter mit dem Wert SilentlyContinueverwendet.

Die Beispielausgabe zeigt die Ergebnisse der Ausführung beider Skripts, wenn die Benutzeroberflächenkultur auf fr-BE festgelegt ist und keine übereinstimmenden Dateien oder Verzeichnisse für diese Benutzeroberflächenkultur vorhanden sind. Day1.ps1 zeigt eine Fehlermeldung und eine englische Ausgabe an. Day2.ps1 zeigt nur die englische Ausgabe an.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Import-LocalizedData speichert die Hashtabelle in der Variablen, die durch den Wert des BindingVariable-Parameters angegeben wird.

• Bevor Sie Import-LocalizedDataverwenden, lokalisieren Sie Ihre Benutzernachrichten. Formatieren Sie die Meldungen für jedes Gebietsschema (Benutzeroberflächenkultur) in einer Hashtabelle mit Schlüssel-Wert-Paaren, und speichern Sie die Hashtabelle in einer Datei mit dem gleichen Namen wie das Skript und einer .psd1 Dateinamenerweiterung. Erstellen Sie ein Verzeichnis unter dem Skriptverzeichnis für jede unterstützte Benutzeroberflächenkultur, und speichern Sie dann die .psd1 Datei für jede Benutzeroberflächenkultur im Verzeichnis mit dem Namen der Benutzeroberflächenkultur.

  Lokalisieren Sie z. B. Ihre Benutzernachrichten für das Gebietsschema de-DE, und formatieren Sie sie in einer Hashtabelle. Speichern Sie die Hash-Tabelle in einer <ScriptName>.psd1 Datei. Erstellen Sie dann ein de-DE Unterverzeichnis unter dem Skriptverzeichnis, und speichern Sie die deutsche <ScriptName\>.psd1-Datei im Unterverzeichnis de-DE. Wiederholen Sie diese Methode für jedes gebietsschema, das Sie unterstützen.

• Import-LocalizedData führt eine strukturierte Suche nach den lokalisierten Benutzernachrichten für ein Skript aus.

  Import-LocalizedData beginnt die Suche im Verzeichnis, in dem sich die Skriptdatei befindet (oder den Wert des BaseDirectory-Parameters). Anschließend wird im Basisverzeichnis nach einem Unterverzeichnis mit demselben Namen wie der Wert der $PsUICulture Variablen (oder der Wert des UICulture Parameters) durchsucht, z. B. de-DE oder ar-SA. Anschließend wird in diesem Unterverzeichnis nach einer .psd1 Datei mit demselben Namen wie das Skript (oder der Wert des FileName-Parameters) durchsucht.

  Wenn Import-LocalizedData kein Unterverzeichnis mit dem Namen der Benutzeroberflächenkultur gefunden werden kann oder das Unterverzeichnis keine .psd1 Datei für das Skript enthält, wird in einem Unterverzeichnis mit dem Namen des Sprachcodes, z. B. de oder ar, nach einer .psd1 Datei für das Skript gesucht. Wenn das Unterverzeichnis oder .psd1 die Datei nicht gefunden werden kann, schlägt der Befehl fehl, die Daten werden in der Standardsprache im Skript angezeigt, und es wird eine Fehlermeldung angezeigt, die erklärt, dass die Daten nicht importiert werden konnten. Um die Nachricht zu unterdrücken und ordnungsgemäß fehlzuschlagen, verwenden Sie den ErrorAction allgemeinen Parameter mit dem Wert "SilentlyContinue".

  Wenn Import-LocalizedData das Unterverzeichnis und die .psd1 Datei gefunden wird, wird die Hashtabelle der Benutzernachrichten in den Wert des Parameters BindingVariable im Befehl importiert. Wenn Sie dann eine Nachricht aus der Hash-Tabelle in der Variablen anzeigen, wird die lokalisierte Nachricht angezeigt.

  Weitere Informationen finden Sie unter about_Script_Internationalization.