Partilhar via

sobre_Internacionalização_de_Script

Breve descrição

Descreve os recursos de internacionalização de scripts que facilitam a exibição de mensagens e instruções para os usuários em seu idioma de interface do usuário (UI).

Descrição longa

Os recursos de internacionalização de script do PowerShell permitem que você atenda melhor os usuários em todo o mundo, exibindo a ajuda e as mensagens do usuário no idioma do usuário.

Os recursos de internacionalização de script consultam a cultura da interface do usuário do sistema operacional durante a execução, importam as cadeias de texto traduzidas apropriadas e as exibem para o usuário. A seção Dados permite armazenar cadeias de texto separadas do código para que sejam facilmente identificadas e extraídas. Um novo cmdlet, ConvertFrom-StringData, converte cadeias de texto em tabelas de hash semelhantes a dicionários para facilitar a tradução.

Para dar suporte ao texto da Ajuda internacional, o PowerShell inclui os seguintes recursos:

  • Uma seção Data que separa cadeias de caracteres de texto de instruções de código. Para obter mais informações sobre a seção Dados, consulte about_Data_Sections.

  • Novas variáveis automáticas, $PSCulture e $PSUICulture. $PSCulture armazena o nome do idioma da interface do usuário usado no sistema para elementos como data, hora e moeda. A variável $PSUICulture armazena o nome do idioma da interface do usuário usado no sistema para elementos da interface do usuário, como menus e cadeias de texto.

  • Um cmdlet, ConvertFrom-StringData, que converte cadeias de texto em tabelas de hash semelhantes a dicionários para facilitar a tradução. Para obter mais informações, consulte ConvertFrom-StringData.

  • Um novo tipo de arquivo, .psd1, que armazena cadeias de texto traduzidas. Os arquivos .psd1 são armazenados em subdiretórios específicos do idioma do diretório script.

  • Um cmdlet, Import-LocalizedData, que importa cadeias de caracteres de texto traduzidas para um idioma especificado em um script em tempo de execução. Este cmdlet reconhece e importa cadeias de caracteres em qualquer idioma suportado pelo Windows. Para obter mais informações, consulte Import-LocalizedData.

A secção Dados: Armazenamento de cadeias de caracteres predefinidas

Use uma seção Dados no script para armazenar as cadeias de texto no idioma padrão. Organize as cadeias de caracteres em pares chave/valor numa here-string. Cada par chave/valor deve estar em uma linha separada. Se você incluir comentários, os comentários devem estar em linhas separadas.

O cmdlet ConvertFrom-StringData converte os pares chave/valor no here-string em uma tabela de hash, semelhante a um dicionário, que é armazenada no valor da variável da secção de Dados.

No exemplo a seguir, a seção Data do script World.ps1 inclui o conjunto de mensagens de prompt de English-United States (en-US) para um script. O cmdlet ConvertFrom-StringData converte as cadeias de caracteres em uma tabela de hash e as armazena na variável $msgtable.

$msgTable = data {
    #culture="en-US"
    ConvertFrom-StringData @'
    helloWorld = Hello, World.
    errorMsg1 = You cannot leave the user name field blank.
    promptMsg = Please enter your user name.
'@
}

Para obter mais informações sobre here-strings, consulte about_Quoting_Rules.

Arquivos PSD1: Armazenando cadeias de caracteres traduzidas

Salve as mensagens de script para cada idioma da interface do usuário em arquivos de texto separados com o mesmo nome do script e a extensão de nome de arquivo .psd1. Armazene os arquivos em subdiretórios do diretório de script com nomes de culturas no seguinte formato:

<language>-<region>

Exemplos: de-DE, ar-SAe zh-Hans

Por exemplo, se o script World.ps1 estiver armazenado no diretório C:\Scripts, você criará uma estrutura de diretório de arquivos semelhante à seguinte:

C:\Scripts
C:\Scripts\World.ps1
C:\Scripts\de-DE\World.psd1
C:\Scripts\ar-SA\World.psd1
C:\Scripts\zh-CN\World.psd1
...

O arquivo World.psd1 no subdiretório de-DE do diretório de script pode incluir a seguinte instrução:

ConvertFrom-StringData -StringData @'
helloWorld = Hallo, Welt.
errorMsg1 = Das Feld Benutzername darf nicht leer sein.
promptMsg = Geben Sie Ihren Benutzernamen ein.
'@

Da mesma forma, o arquivo World.psd1 no subdiretório ar-SA do diretório de script pode incluir a seguinte instrução:

ConvertFrom-StringData -StringData @'
helloWorld = مرحبًا أيها العالَم
errorMsg1 = لا يمكنك ترك حقل اسم المستخدم فارغًا
promptMsg = يرجى إدخال اسم المستخدم الخاص بك
'@

Import-LocalizedData: recuperação dinâmica de cadeias de caracteres traduzidas

Para recuperar as strings no idioma da interface do utilizador atual, use o cmdlet Import-LocalizedData.

Import-LocalizedData localiza o valor da variável automática $PSUICulture e importa o conteúdo dos arquivos de <script-name>.psd1 no subdiretório que corresponde ao valor $PSUICulture. Em seguida, ele salva o conteúdo importado na variável especificada pelo valor do parâmetro BindingVariable.

Import-LocalizedData -BindingVariable msgTable

Por exemplo, se o comando Import-LocalizedData aparecer no script C:\Scripts\World.ps1 e o valor de $PSUICulture for "ar-SA", Import-LocalizedData localizará o seguinte arquivo:

C:\Scripts\ar-SA\World.psd1

Em seguida, ele importa as cadeias de caracteres de texto árabe do arquivo para a variável $msgTable, substituindo quaisquer cadeias de caracteres padrão que possam ser definidas na seção Dados do script World.ps1.

Como resultado, quando o script usa a variável $msgTable para exibir mensagens do usuário, as mensagens são exibidas em árabe.

Por exemplo, o script a seguir exibe a mensagem "Digite seu nome de usuário" em árabe:

if (!($username)) { $msgTable.promptMsg }

Se Import-LocalizedData não conseguir encontrar um arquivo .psd1 que corresponda ao valor de $PSUICulture, o valor de $msgTable não será substituído e a chamada para $msgTable.promptMsg exibirá as cadeias de fallback en-US.

Examples

Este exemplo mostra como os recursos de internacionalização de script são usados em um script para exibir um dia da semana aos usuários no idioma definido no computador.

A seguir está uma lista completa do arquivo de script Sample1.ps1.

O script começa com uma seção Data chamada Day ($Day) que contém um comando ConvertFrom-StringData. A expressão submetida para ConvertFrom-StringData é uma cadeia de caracteres do tipo here-string que contém os nomes dos dias na cultura padrão da interface de utilizador, en-US, em pares de chave/valor. O cmdlet ConvertFrom-StringData converte os pares chave/valor na cadeia de caracteres aqui numa tabela de hash e depois salva-a no valor da variável $Day.

O comando Import-LocalizedData importa o conteúdo do arquivo .psd1 no diretório que corresponde ao valor da variável automática $PSUICulture e, em seguida, salva-o na variável $Day, substituindo os valores de $Day definidos na seção Dados.

Os comandos restantes carregam as cadeias de caracteres em uma matriz e as exibem.

$Day = data {
#culture="en-US"
ConvertFrom-StringData -StringData @'
    messageDate = Today is
    d0 = Sunday
    d1 = Monday
    d2 = Tuesday
    d3 = Wednesday
    d4 = Thursday
    d5 = Friday
    d6 = Saturday
'@
}

Import-LocalizedData -BindingVariable Day

#Build an array of weekdays.
$a = $Day.d0, $Day.d1, $Day.d2, $Day.d3, $Day.d4, $Day.d5, $Day.d6

# Get the day of the week as a number (Monday = 1).
# Index into $a to get the name of the day.
# Use string formatting to build a sentence.

"{0} {1}" -f $Day.messageDate, $a[(Get-Date -UFormat %u)] | Out-Host

Os arquivos .psd1 que suportam o script são salvos em subdiretórios do diretório de script com nomes que correspondem aos valores $PSUICulture.

Segue-se uma lista completa de .\de-DE\sample1.psd1:

# culture="de-DE"
ConvertFrom-StringData @'
    messageDate = Heute ist
    d0 = Sonntag
    d1 = Montag
    d2 = Dienstag
    d3 = Mittwoch
    d4 = Donnerstag
    d5 = Freitag
    d6 = Samstag
'@

Como resultado, quando você executa Sample.ps1 em um sistema no qual o valor de $PSUICulture é de-DE, a saída do script é:

Heute ist Freitag

Consulte também

  • Last updated on