Import-LocalizedData

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

C:\PS>import-localizeddata -bindingVariable messages

Descrição
-----------
Este comando importa cadeias de texto na variável $messages. Ele usa todos os valores padrão para os parâmetros de cmdlet.

Se o comando for incluído no script Archives.ps1 no diretório C:\test, e o valor da variável automática $PsUICulture for zh-CN, Import-LocalizedData importa o arquivo Archives.psd1 para o diretório C:\test\zh-CN.

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

Descrição
-----------
Este comando importa cadeias de texto para a variável $msgTbl de um script. 

Usa o parâmetro UICulture para direcionar o cmdlet para importar dados do arquivo Simple.psd1 no subdiretório ar-SA de 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.

Descrição
-----------
Este exemplo mostra como usar dados localizados em um script simples.

A primeira parte do exemplo mostra o conteúdo do arquivo Test.psd1. Ele contém um comando ConvertFrom-StringData que converte uma série de cadeias de texto nomeadas em uma tabela de hash. O arquivo test.psd1 está localizado no subdiretório en-US do diretório C:\Test que contém o script.

A segunda parte do exemplo mostra o conteúdo do script Test.ps1. Ele contém um comando Import-LocalizedData que importa os dados do arquivo .psd1 correspondente na variável $Messages e um comando Write-Host que escreve uma das mensagens na variável $Messages para o programa host.

A última parte do exemplo executa o script. A saída mostra que ele exibe a mensagem de usuário correta no idioma de interface do usuário definido para o usuário atual do sistema operacional.

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

Descrição
-----------
Esse exemplo mostra como usar Import-LocalizedData para substituir cadeias de texto padrão definidos na seção DATA de um script.

Neste exemplo, a seção DATA do script TestScript.ps1 contém um comando ConvertFrom-StringData que converte o conteúdo da seção DATA em uma tabela de hash e o armazena no valor da variável $UserMessages. 

Além disso, o script inclui um comando Import-LocalizedData, o qual importa uma tabela de hash de cadeias de texto convertidas do arquivo TestScript.psd1 no subdiretório especificado pelo valor da variável $PsUICulture. Se o comando localizar o arquivo .psd1, ele salvará as cadeias de caracteres convertidas do arquivo no valor da mesma variável $ UserMessages, substituindo a tabela de hash salva pela lógica de seção DATA.

O terceiro comando exibe a primeira mensagem na variável $UserMessages.

Se o comando Import-LocalizedData localizar um arquivo .psd1 para o idioma $PsUICulture, o valor da variável $UserMessages conterá as cadeias de texto convertidas. Se o comando falhar por qualquer razão, o comando exibirá as cadeias de texto padrão definidas na seção DATA do script.

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

Descrição
-----------
Este exemplo mostra como suprimir as mensagens de erro que aparecem quando Import-LocalizedData não consegue localizar os diretórios que correspondem à cultura da interface do usuário ou um arquivo .psd1 para o script nesses diretórios.

Pode-se usar o parâmetro comum ErrorAction com um valor de “SilentlyContinue” para suprimir a mensagem de erro. Isso é especialmente útil quando você fornecer mensagens de usuário em um padrão ou idioma de "fallback" e nenhuma mensagem de erro é necessária.

Esse exemplo compara dois scripts, Day1.ps1 e Day2.ps1, que incluem um comando Import-LocalizedData. Os scripts são idênticos, exceto pelo fato de que Day2 usa o parâmetro comum ErrorAction com um valor de SilentlyContinue.

O exemplo de saída mostra os resultados da execução de ambos os scripts quando a cultura da interface do usuário é definida para fr-BE e não há nenhum arquivo ou diretório compatível para aquela cultura de interface do usuário. Day1.ps1 exibe uma mensagem de erro e saída em inglês. Day2.ps1 exibe apenas a saída em inglês.