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 매개 변수를 사용하여 C:\Data\Localized의 ar-SA 하위 디렉터리에 있는 Simple.psd1 파일의 데이터를 가져오도록 cmdlet에 지시합니다.

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 스크립트의 내용을 보여 줍니다. 여기에는 일치하는 .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 섹션에 DATA 섹션의 내용을 해시 테이블로 변환하고 $UserMessages 변수의 값에 저장하는 ConvertFrom-StringData 명령이 포함되어 있습니다. 

스크립트에는 $PsUICulture 변수의 값에 의해 지정된 하위 디렉터리의 TestScript.psd1 파일에서 변환된 텍스트 문자열의 해시 테이블을 가져오는 Import-LocalizedData 명령이 포함되어 있습니다. 명령에서 .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 culture와 일치하는 디렉터리를 찾을 수 없거나 해당 디렉터리에서 스크립트에 대한 .psd1 파일을 찾을 수 없을 때 표시되는 오류 메시지를 무시하는 방법을 보여 줍니다.

값이 "SilentlyContinue"인 ErrorAction 일반 매개 변수를 사용하여 오류 메시지를 무시할 수 있습니다. 이 매개 변수는 사용자 메시지를 기본 언어 또는 "대체" 언어로 제공 받았을 때 오류 메시지가 필요하지 않은 경우 특히 유용합니다.

이 예에서는 Import-LocalizedData 명령을 포함하는 두 스크립트인 Day1.ps1과 Day2.ps1을 비교합니다. Day2가 값이 SilentlyContinue인 ErrorAction 일반 매개 변수를 사용한다는 점을 제외하면 이 두 스크립트는 동일합니다.

샘플 출력에서는 UI culture가 fr-BE로 설정되어 있으며 해당 UI culture에 일치하는 파일이나 디렉터리가 없을 때 두 스크립트를 실행한 결과를 보여 줍니다. Day1.ps1의 경우에는 오류 메시지와 영문 출력이 표시되지만 Day2.ps1의 경우에는 영문 출력만 표시됩니다.