Import-LocalizedData

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

C:\PS>import-localizeddata -bindingVariable messages

Описание
-----------
Эта команда импортирует текстовые строки в переменную $messages. Она использует все значения по умолчанию параметров командлета.

Если команда включена в скрипт Archives.ps1 в каталоге C:\test, а автоматическая переменная $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, чтобы командлет импортировал данные из файла Simple.psd1 в подкаталоге ar-SA каталога C:\Data\Localized.

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 расположен в подкаталоге en-US каталога C:\Test directory, содержащего скрипт.

Во второй части примера показано содержимое файла Test.ps1. В ней содержится команда Import-LocalizedData, импортирующая данные из соответствующего файла PDS1 в переменную $Messages, а также команда Write-Host, записывающая одно из сообщений из переменной $Messages в основную программу.

Последняя команда в этом примере выполняет скрипт. Выходные данные подтверждают, что отображается надлежащее пользовательское сообщение на языке пользовательского интерфейса, заданного для текущего пользователя операционной системы.

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 скрипта.

В этом примере раздел DATA скрипта TestScript.ps1 содержит команду ConvertFrom-StringData, преобразующую содержимое раздела DATA в хэш-таблицу и сохраняющая ее в качестве значения переменной $UserMessages. 

В скрипте также используется команда Import-LocalizedData, импортирующая хэш-таблицу с переведенными текстовыми строками из файла TestScript.psd1 в подкаталоге, заданном переменной $PsUICulture. Если команда находит файл PSD1, она сохраняет переведенные строки из файла в ту же самую переменную $UserMessages вместо хэш-таблицы, сохраненной логикой из раздела DATA.

Третья команда отображает первое сообщение из переменной $UserMessages.

Если команда Import-LocalizedData находит файл PSD1 для языка $PsUICulture, значение переменной $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 не удается найти каталоги, соответствующие заданной культуре пользовательского интерфейса, или файл PSD1 для скрипта в этих каталогах.

Используя общий параметр ErrorAction со значением SilentlyContinue, можно отключить появление сообщений об ошибках. Это бывает особенно полезным, если имеются пользовательские сообщения на языке по умолчанию или "резервном" языке, и показывать сообщения об ошибках не нужно.

В этом примере сравниваются два скрипта (Day1.ps1 и Day2.ps1), которые включают команду Import-LocalizedData. Эти скрипты идентичны за исключением того, что в скрипте Day2 используется общий параметр ErrorAction со значением SilentlyContinue.

Результат выполнения примера показывает, что произойдет при запуске обоих скриптов, если для культуры пользовательского интерфейса установлено значение fr-BE, а соответствующие файлы и каталоги отсутствуют. Скрипт Day1.ps1 выводит сообщение об ошибке и текст на английском языке. Скрипт Day2.ps1 выводит только текст на английском языке.