Import-LocalizedData

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

C:\PS>import-localizeddata -bindingVariable messages

説明
-----------
このコマンドは、テキスト文字列を $messages 変数にインポートします。また、コマンドレット パラメーターのすべての既定値を使用します。

このコマンドが C:\test ディレクトリ内の Archives.ps1 スクリプトに含まれており、$PsUICulture 自動変数の値が zh-CN の場合、Import-LocalizedData は Archives.psd1 ファイルを C:\test\zh-CN ディレクトリにインポートします。

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

説明
-----------
このコマンドは、テキスト文字列をスクリプトの $msgTbl 変数にインポートします。

また、UICulture パラメーターを使用して、C:\Data\Localized の ar-SA サブディレクトリ内の Simple.psd1 ファイルからデータをインポートするようにコマンドレットに指示します。

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.

説明
-----------
この例は、単純なスクリプトでローカライズされたデータを使用する方法を示しています。

この例の最初の部分は、Test.psd1 ファイルの内容を示しています。この部分には、一連の名前付きテキスト文字列をハッシュ テーブルに変換する ConvertFrom-StringData コマンドが含まれています。test.psd1 ファイルは、スクリプトが含まれている C:\Test ディレクトリの en-US サブディレクトリにあります。

この例の 2 番目の部分は、Test.ps1 スクリプトの内容を示しています。この部分には、一致する .psd1 ファイルからのデータを $Messages 変数にインポートする Import-LocalizedData コマンドのほか、$Messages 変数内のいずれかのメッセージをホスト プログラムに書き込む Write-Host コマンドが含まれています。

この例の最後は、スクリプトを実行する部分です。出力結果からは、オペレーティング システムの現在のユーザーに対して設定されている UI 言語で、正しいユーザー メッセージが表示されていることがわかります。

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

説明
-----------
この例は、Import-LocalizedData を使用して、スクリプトの DATA セクションで定義された既定のテキスト文字列を置換する方法を示しています。

この例では、TestScript.ps1 スクリプトの DATA セクションに、ConvertFrom-StringData コマンドが存在します。このコマンドによって、DATA セクションの内容がハッシュ テーブルに変換され、$UserMessages 変数の値に保存されます。

このスクリプトには、Import-LocalizedData コマンドも使用されています。このコマンドは、TestScript.psd1 ファイルの翻訳済みテキスト文字列のハッシュ テーブルを $PsUICulture 変数の値で指定されたサブディレクトリにインポートします。この .psd1 ファイルが見つかった場合、そのファイルの翻訳済みの文字列を同じ $UserMessages 変数の値に保存し、DATA セクションのロジックで保存されたハッシュ テーブルを上書きします。

3 番目のコマンドは、$UserMessages 変数の最初のメッセージを表示します。

Import-LocalizedData コマンドが $PsUICulture 言語の .psd1 ファイルを検出した場合、$UserMessages 変数の値には翻訳済みのテキスト文字列が含まれています。何かの理由でコマンドが失敗した場合は、スクリプトの DATA セクションで定義された既定のテキスト文字列が表示されます。

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

説明
-----------
この例は、Import-LocalizedData によって、ユーザーの UI カルチャに一致するディレクトリが検出されない場合、またはこのようなディレクトリでスクリプトの .psd1 ファイルが検出されない場合に、エラー メッセージが表示されないようにする方法を示しています。

値が "SilentlyContinue" の ErrorAction 共通パラメーターを使用すると、エラー メッセージを表示しないようにすることができます。これは、既定の言語またはフォールバック言語でユーザー メッセージが指定されている場合、およびエラー メッセージが不要な場合に特に便利です。

この例では、Import-LocalizedData コマンドを含んでいる Day1.ps1 と Day2.ps1 の 2 つのスクリプトを比較します。これらのスクリプトは、Day2 では値が SilentlyContinue の ErrorAction 共通パラメーターを使用していることを除いて同じです。

サンプル出力は、UI カルチャが fr-BE に設定され、その UI カルチャには一致するファイルまたはディレクトリが存在しない場合に両方のスクリプトを実行した結果を示しています。Day1.ps1 の場合、エラー メッセージと英語の出力が表示されます。Day2.ps1 の場合、英語の出力のみが表示されます。