Import-LocalizedData
オペレーティング システム用に選択された UI カルチャに基づいて、言語固有のデータをスクリプトと関数にインポートします。
構文
Import-LocalizedData
[[-BindingVariable] <String>]
[[-UICulture] <String>]
[-BaseDirectory <String>]
[-FileName <String>]
[-SupportedCommand <String[]>]
[<CommonParameters>]
説明
コマンドレットは Import-LocalizedData
、オペレーティング システムの現在のユーザーに設定されている UI 言語と一致する名前のサブディレクトリから文字列を動的に取得します。 スクリプトが現在のユーザーによって選択された UI 言語でユーザー メッセージを表示できるように設計されています。
Import-LocalizedData
は、スクリプト ディレクトリの言語固有のサブディレクトリにあるファイルから .psd1
データをインポートし、コマンドで指定されたローカル変数に保存します。 コマンドレットは、自動変数の値に基づいてサブディレクトリとファイルを $PSUICulture
選択します。 スクリプトのローカル変数を使用してユーザー メッセージを表示すると、ユーザーの UI 言語でメッセージが表示されます。
パラメーター Import-LocalizedData
を使用して、代替 UI カルチャ、パス、ファイル名を指定し、サポートされているコマンドを追加したり、ファイルが見つからない場合に表示されるエラー メッセージを .psd1
抑制したりできます。
このコマンドレットは Import-LocalizedData
、Windows PowerShell 2.0 で導入されたスクリプトの国際化イニシアチブをサポートしています。 このイニシアチブは、スクリプトを使用して現在のユーザーの UI 言語でユーザー メッセージを容易に表示できるようにして、世界中のユーザーのサービス向上を目的としています。 この方法とファイルの形式の詳細については、about_Script_Internationalizationを.psd1
参照してください。
例
例 1: テキスト文字列をインポートする
次の使用例は、テキスト文字列を変数に $Messages
インポートします。 その他のすべてのコマンドレットのパラメーターの既定値を使用します。
Import-LocalizedData -BindingVariable "Messages"
コマンドがディレクトリの Archives.ps1 スクリプトにC:\Test
含まれていて、自動変数の$PsUICulture
値が zh-CN の場合は、Import-LocalizedData
ディレクトリ内のファイルをC:\test\zh-CN
変数に$Messages
インポートArchives.psd1
します。
例 2: ローカライズされたデータ文字列をインポートする
この例は、スクリプト内ではなくコマンド ラインで実行されます。 Test.psd1 ファイルからローカライズされたデータの文字列を取得し、コマンドラインに表示します。 このコマンドはスクリプトでは使用されないため、 FileName パラメーターが必要です。 このコマンドでは、UICulture パラメーターを使用して en-US カルチャを指定します。
Import-LocalizedData -FileName "Test.psd1" -UICulture "en-US"
Name Value
---- -----
Msg3 "Use $_ to represent the object that's 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
は、ローカライズされたデータ文字列を含むハッシュテーブルを返します。
例 3: UI カルチャ文字列をインポートする
Import-LocalizedData -BindingVariable "MsgTbl" -UICulture "ar-SA" -FileName "Simple" -BaseDirectory "C:\Data\Localized"
このコマンドは、スクリプトの変数にテキスト文字列を $MsgTbl
インポートします。
UICulture パラメーターを使用して、コマンドレットに対して、サブディレクトリC:\Data\Localized
内のファイルからデータをSimple.psd1
ar-SA
インポートするように指示します。
例 4: ローカライズされたデータをスクリプトにインポートする
この例は、単純なスクリプト内のローカライズされたデータを表示する方法を示します。
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's 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.
この例の最初の部分は、ファイルの内容を Test.psd1
示しています。 これには、 ConvertFrom-StringData
一連の名前付きテキスト文字列をハッシュテーブルに変換するコマンドが含まれています。 ファイルは Test.psd1
、スクリプトを含むディレクトリの C:\Test
en-US サブディレクトリにあります。
この例の 2 番目の部分は、スクリプトの内容を Test.ps1
示しています。 これには、一致するImport-LocalizedData
.psd1
ファイルから変数に$Messages
データをインポートするコマンドと、Write-Host
変数内$Messages
のメッセージの 1 つをホスト プログラムに書き込むコマンドが含まれています。
例の最後の部分で、スクリプトを実行します。 出力は、オペレーティング システムの現在のユーザーのために設定された UI の言語で正しいユーザー メッセージが表示されることを示しています。
例 5: スクリプト内の既定のテキスト文字列を置き換える
この例では、スクリプトの Import-LocalizedData
DATA セクションで定義されている既定のテキスト文字列を置き換える方法を示します。
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...
この例では、TestScript.ps1 スクリプトの DATA セクションに、DATA セクションの内容をハッシュテーブルに変換し、変数の値に格納するコマンドが$UserMessages
含まれていますConvertFrom-StringData
。
スクリプトには、変数の値で指定されたサブディレクトリ内の TestScript.psd1 ファイルから翻訳されたテキスト文字列の$PsUICulture
ハッシュテーブルをインポートするコマンドも含まれていますImport-LocalizedData
。 コマンドでファイルが .psd1
見つかると、変換された文字列が同じ $UserMessages
変数の値に保存され、DATA セクション ロジックによって保存されたハッシュテーブルが上書きされます。
3 番目のコマンドは、変数の最初のメッセージを $UserMessages
表示します。
コマンドが Import-LocalizedData
言語のファイルを .psd1
検索した $PsUICulture
場合、変数の $UserMessages
値には翻訳されたテキスト文字列が含まれます。 コマンドが何らかの理由で失敗した場合、スクリプトの DATA セクションに定義されている既定のテキスト文字列が表示されます。
例 6: UI カルチャが見つからない場合にエラー メッセージを抑制する
この例では、ユーザーの UI カルチャに一致するディレクトリが見つからない場合、またはそれらのディレクトリにスクリプトのファイルが見.psd1
つからない場合Import-LocalizedData
に表示されるエラー メッセージを抑制する方法を示します。
PS C:\> # In Day1.ps1
Import-LocalizedData -BindingVariable "Day"
# In Day2.ps1
Import-LocalizedData -BindingVariable "Day" -ErrorAction:SilentlyContinue
PS C:\> .\Day1.ps1
Import-LocalizedData : Can't 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
ErrorAction 共通パラメーターを SilentlyContinue の値と共に使用すると、エラー メッセージを抑制できます。 これは、既定の言語またはフォールバック言語でユーザー メッセージを指定していて、エラー メッセージが不要な場合に特に便利です。
この例では、 Day1.ps1
コマンドを含む 2 つのスクリプトと Day2.ps1 を Import-LocalizedData
比較します。 スクリプトは同じですが、Day2 では ErrorAction 共通パラメーターが値SilentlyContinue
として使用されます。
サンプル出力は、UI カルチャが設定されていて、その UI カルチャに一致するファイルまたはディレクトリがない場合に fr-BE
、両方のスクリプトを実行した結果を示しています。 Day1.ps1
には、エラー メッセージと英語の出力が表示されます。 Day2.ps1
単に英語の出力を表示します。
パラメーター
-BaseDirectory
ファイルが配置されているベース ディレクトリを .psd1
指定します。 既定では、スクリプトが配置されているディレクトリです。 Import-LocalizedData
は、ベース ディレクトリの .psd1
言語固有のサブディレクトリにあるスクリプトのファイルを検索します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BindingVariable
テキスト文字列のインポート先の変数を指定します。 変数名をドル記号 ($
) なしで入力します。
Windows PowerShell 2.0 ではこのパラメーターは必須です。 Windows PowerShell 3.0 ではこのパラメーターは省略可能です。 このパラメーターを省略すると、 Import-LocalizedData
テキスト文字列のハッシュテーブルが返されます。 ハッシュテーブルはパイプラインに渡されるか、コマンド ラインに表示されます。
スクリプトの DATA セクションで指定された既定のテキスト文字列を置き換えるために使用Import-LocalizedData
する場合は、DATA セクションを変数に割り当て、BindingVariable パラメーターの値に DATA セクション変数の名前を入力します。 次に、インポートしたコンテンツを BindingVariable に保存するとImport-LocalizedData
、インポートされたデータによって既定のテキスト文字列が置き換えられます。 既定のテキスト文字列を指定しない場合は、任意の変数名を選択できます。
Type: | String |
Aliases: | Variable |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileName
インポートするデータ ファイル.psd1)
の名前を指定します。 ファイル名を入力します。 ファイル名拡張子を含 .psd1
まないファイル名を指定することも、ファイル名拡張子を含むファイル名を .psd1
指定することもできます。 データ ファイルは Unicode または UTF-8 として保存する必要があります。
FileName パラメーターは、スクリプトで使用されていない場合Import-LocalizedData
に必要です。
それ以外の場合、このパラメーターは省略可能であり、既定値はスクリプトのベース名です。 このパラメーターを使用すると、別.psd1
のファイルを検索するように指示Import-LocalizedData
できます。
たとえば、FileName を省略し、スクリプト名を指定FindFiles.ps1
すると、Import-LocalizedData
データ ファイルがFindFiles.psd1
検索されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SupportedCommand
データのみを生成するコマンドレットと関数を指定します。
このパラメーターを使用して、記述またはテストしたコマンドレットと関数を指定します。 詳細については、「about_Script_Internationalization」を参照してください。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UICulture
代替の UI カルチャを指定します。 既定値は自動変数の $PsUICulture
値です。 などの形式で <language>-<region>
UI カルチャを入力しますar-SA
。en-US
de-DE
UICulture パラメーターの値によって、スクリプトのファイルを取得.psd1
する言語固有のサブディレクトリ (ベース ディレクトリ内) がImport-LocalizedData
決まります。
コマンドレットは、UICulture パラメーターまたは$PsUICulture
自動変数de-DE
の値と同じ名前のサブディレクトリを検索します(例: .ar-SA
ディレクトリが見つからない場合、またはディレクトリにスクリプトのファイルが含 .psd1
まれていない場合は、言語コードの名前を持つサブディレクトリ (de や ar など) を検索します。 サブディレクトリまたは .psd1
ファイルが見つからない場合、コマンドは失敗し、スクリプトで指定された既定の言語でデータが表示されます。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
このコマンドレットは、BindingVariable パラメーターの値で指定された変数にハッシュテーブルを保存します。
メモ
使用する
Import-LocalizedData
前に、ユーザー メッセージをローカライズします。 キーと値のペアのハッシュテーブルに各ロケール (UI カルチャ) のメッセージを書式設定し、スクリプトと同じ名前とファイル名拡張子を持つファイルにハッシュテーブルを.psd1
保存します。 サポートされている UI カルチャごとにスクリプト ディレクトリの下にディレクトリを作成し、UI カルチャ名を使用してディレクトリ内の各 UI カルチャのファイルを保存.psd1
します。たとえば、de-DE ロケールのユーザー メッセージをローカライズし、ハッシュテーブルに書式設定します。 ハッシュテーブルをファイルに
<ScriptName>.psd1
保存します。 次に、de-DE
スクリプト ディレクトリの下にサブディレクトリを作成し、ドイツ語<ScriptName>.psd1
ファイルをサブディレクトリにde-DE
保存します。 サポートしているロケールごとにこのメソッドを繰り返します。Import-LocalizedData
は、スクリプトのローカライズされたユーザー メッセージの構造化検索を実行します。Import-LocalizedData
は、スクリプト ファイルが配置されているディレクトリ (または BaseDirectory パラメーターの値) で検索を開始します。 次に、基本ディレクトリ内で、変数の値 (または UICulture パラメーターの値) と同じ名前の$PsUICulture
サブディレクトリを検索します(例: .ar-SA
de-DE
次に、そのサブディレクトリ.psd1
で、スクリプトと同じ名前のファイル (または FileName パラメーターの値) を検索します。UI カルチャの名前を持つサブディレクトリが見つからない場合、またはサブディレクトリにスクリプトのファイルが含
.psd1
まれていない場合Import-LocalizedData
は、de や ar などの言語コードの名前を持つサブディレクトリ内のスクリプトのファイルを検索.psd1
します。 サブディレクトリまたは.psd1
ファイルが見つからない場合、コマンドは失敗し、スクリプトの既定の言語でデータが表示され、データをインポートできなかったことを示すエラー メッセージが表示されます。 メッセージを抑制し、正常に失敗するには、ErrorAction 共通パラメーターを値 SilentlyContinue と共に使用します。Import-LocalizedData
サブディレクトリとファイルが.psd1
見つかると、コマンドの BindingVariable パラメーターの値にユーザー メッセージのハッシュテーブルがインポートされます。 次に、ハッシュテーブルからのメッセージを変数に表示すると、ローカライズされたメッセージが表示されます。詳細については、「about_Script_Internationalization」を参照してください。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示