Condividi tramite

about_Script_Internationalization

Breve descrizione

Descrive le funzionalità di internazionalizzazione dello script che semplificano la visualizzazione di messaggi e istruzioni agli utenti nel linguaggio dell'interfaccia utente.

Descrizione lunga

Le funzionalità di internazionalizzazione degli script di PowerShell consentono di offrire un servizio migliore agli utenti in tutto il mondo visualizzando i messaggi della Guida e degli utenti nella lingua dell'utente.

Le funzionalità di internazionalizzazione dello script interrogano la cultura dell'interfaccia utente del sistema operativo durante l'esecuzione, importano le stringhe di testo tradotte appropriate e le presentano all'utente. La sezione Dati consente di archiviare stringhe di testo separate dal codice in modo che vengano facilmente identificate ed estratte. Un nuovo cmdlet, ConvertFrom-StringData, converte le stringhe di testo in tabelle hash simili a dizionario per facilitare la traduzione.

Per supportare il testo della Guida internazionale, PowerShell include le funzionalità seguenti:

  • Sezione Dati che separa le stringhe di testo dalle istruzioni di codice. Per altre informazioni sulla sezione Dati, vedere about_Data_Sections.

  • Nuove variabili automatiche, $PSCulture e $PSUICulture. $PSCulture archivia il nome della lingua dell'interfaccia utente usata nel sistema per elementi quali data, ora e valuta. La variabile $PSUICulture archivia il nome della lingua dell'interfaccia utente usata nel sistema per elementi dell'interfaccia utente, ad esempio menu e stringhe di testo.

  • Cmdlet, ConvertFrom-StringData, che converte le stringhe di testo in tabelle hash simili a dizionario per facilitare la traduzione. Per altre informazioni, vedere ConvertFrom-StringData.

  • Nuovo tipo di file, .psd1, che archivia le stringhe di testo tradotte. I file .psd1 vengono archiviati nelle sottodirectory specifiche della lingua della directory script.

  • Cmdlet, Import-LocalizedData, che importa stringhe di testo tradotte per una lingua specificata in uno script in fase di esecuzione. Questo cmdlet riconosce e importa le stringhe in qualsiasi linguaggio supportato da Windows. Per altre informazioni, vedere Import-LocalizedData.

Sezione Dati: Archiviazione di stringhe predefinite

Usare una sezione Data nello script per archiviare le stringhe di testo nella lingua predefinita. Disporre le stringhe in coppie chiave/valore in una stringa here.Arrange the strings in key/value pair in a here-string. Ogni coppia chiave/valore deve trovarsi in una riga separata. Se si includono commenti, i commenti devono trovarsi in righe separate.

Il cmdlet ConvertFrom-StringData converte le coppie chiave/valore nella stringa here in una tabella hash simile al dizionario archiviata nel valore della variabile della sezione Data.

Nell'esempio seguente, la sezione Dati dello script World.ps1 include il set di messaggi di richiesta English-United States (en-US) per uno script. Il cmdlet ConvertFrom-StringData converte le stringhe in una tabella hash e le archivia nella variabile $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.
'@
}

Per ulteriori informazioni sulle here-strings, vedere about_Quoting_Rules.

File PSD1: archiviazione di stringhe tradotte

Salvare i messaggi di script per ogni lingua dell'interfaccia utente in file di testo separati con lo stesso nome dello script e l'estensione del nome file .psd1. Archiviare i file nella directory script, nelle sue sottodirectory, con i nomi delle lingue nel formato seguente:

<language>-<region>

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

Ad esempio, se lo script World.ps1 viene archiviato nella directory C:\Scripts, creare una struttura di directory di file simile alla seguente:

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

Il file World.psd1 nella sottodirectory de-DE della directory script può includere l'istruzione seguente:

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

Analogamente, il file World.psd1 nella sottodirectory ar-SA della directory script potrebbe includere l'istruzione seguente:

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

Import-LocalizedData: recupero dinamico di stringhe tradotte

Per recuperare le stringhe nella lingua dell'interfaccia utente dell'utente corrente, usare il cmdlet Import-LocalizedData.

Import-LocalizedData trova il valore della variabile automatica $PSUICulture e importa il contenuto dei file <script-name>.psd1 nella sottodirectory che corrisponde al valore $PSUICulture. Salva quindi il contenuto importato nella variabile specificata dal valore del parametro BindingVariable.

Import-LocalizedData -BindingVariable msgTable

Ad esempio, se il comando Import-LocalizedData viene visualizzato nello script di C:\Scripts\World.ps1 e il valore di $PSUICulture è "ar-SA", Import-LocalizedData trova il file seguente:

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

Importa quindi le stringhe di testo in arabo dal file nella variabile $msgTable, sostituendo tutte le stringhe predefinite che potrebbero essere definite nella sezione Dati dello script di World.ps1.

Di conseguenza, quando lo script usa la variabile $msgTable per visualizzare i messaggi utente, i messaggi vengono visualizzati in arabo.

Ad esempio, lo script seguente visualizza il messaggio "Immettere il nome utente" in arabo:

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

Se Import-LocalizedData non riesce a trovare un file .psd1 che corrisponde al valore di $PSUICulture, il valore di $msgTable non viene sostituito e la chiamata a $msgTable.promptMsg visualizza le stringhe di fallback en-US.

Esempi

In questo esempio viene illustrato come vengono usate le funzionalità di internazionalizzazione dello script in uno script per visualizzare un giorno della settimana agli utenti nella lingua impostata nel computer.

Di seguito è riportato un elenco completo del file di script Sample1.ps1.

Lo script inizia con una sezione Data denominata Day ($Day) che contiene un comando ConvertFrom-StringData. L'espressione inviata a ConvertFrom-StringData è un here-string che contiene i nomi dei giorni nella cultura UI predefinita, en-US, in coppie chiave/valore. Il cmdlet ConvertFrom-StringData converte le coppie chiave/valore nella stringa here in una tabella hash e quindi la salva nel valore della variabile $Day.

Il comando Import-LocalizedData importa il contenuto del file .psd1 nella directory che corrisponde al valore della variabile automatica $PSUICulture e quindi lo salva nella variabile $Day, sostituendo i valori di $Day definiti nella sezione Dati.

I comandi rimanenti caricano le stringhe in una matrice e le visualizzano.

$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

I file .psd1 che supportano lo script vengono salvati nelle sottodirectory della directory script con nomi corrispondenti ai valori $PSUICulture.

Di seguito è riportato un elenco completo di .\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
'@

Di conseguenza, quando si esegue Sample.ps1 in un sistema in cui il valore di $PSUICulture è de-DE, l'output dello script è:

Heute ist Freitag

Vedere anche

  • Last updated on