Import-LocalizedData

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

C:\PS>import-localizeddata -bindingVariable messages

说明
-----------
此命令将文本字符串导入 $messages 变量中。它使用 cmdlet 参数的所有默认值。

如果该命令包含在 C:\test 目录中的 Archives.ps1 脚本中，且 $PsUICulture 自动变量的值为 zh-CN，则 Import-LocalizedData 会导入 C:\test\zh-CN 目录中的 Archives.psd1 文件。

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

说明
-----------
此命令将文本字符串导入脚本的 $msgTbl 变量中。

它使用 UICulture 参数来指示该 cmdlet 从 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 子目录中。

该示例的第二部分显示 Test.ps1 脚本的内容。它包含一个 Import-LocalizedData 命令（用于将匹配的 .psd1 文件中的数据导入到 $Messages 变量中）和一个 Write-Host 命令（用于将 $Messages 变量中的一条消息写入主机程序）。

该示例的最后部分运行脚本。输出表明，它用为操作系统的当前用户设置的 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 命令，该命令从 $PsUICulture 变量的值所指定的子目录中的 TestScript.psd1 文件中导入已翻译文本字符串的哈希表。如果该命令找到该 .psd1 文件，则将文件中的已翻译字符串保存到 $UserMessages 变量的值中，覆盖由 DATA 节逻辑保存的哈希表。

第三个命令显示 $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。这两个脚本是相同的，但是 Day2 使用具有 SilentlyContinue 值的 ErrorAction 通用参数。

示例输出显示了当 UI 区域性设置为 fr-BE 且该 UI 区域性没有匹配的文件或目录时运行这两个脚本的结果。Day1.ps1 显示一条错误消息和英文输出。Day2.ps1 只显示英文输出。