Import-LocalizedData

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

C:\PS>import-localizeddata -bindingVariable messages

Descrizione
-----------
Con questo comando vengono importate stringhe di testo nella variabile $messages. Vengono utilizzati tutti i valori predefiniti per i parametri del cmdlet.

Se il comando è incluso nello script Archives.ps1 nella directory C:\test, e il valore della variabile automatica $PsUICulture è zh-CN, Import-LocalizedData importa il file Archives.psd1 nella directory C:\test\zh-CN.

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

Descrizione
-----------
Con questo comando vengono importate stringhe di testo nella variabile $msgTb1 di uno script. 

Viene utilizzato il parametro UICulture per indicare al cmdlet di importare dati dal file Simple.psd1 nella sottodirectory ar-SA di 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.

Descrizione
-----------
In questo esempio viene illustrato come utilizzare dati localizzati in uno script semplice.

Nella prima parte dell'esempio viene illustrato il contenuto del file Test.psd1. Contiene un comando ConvertFrom-StringData tramite cui viene convertita una serie di stringhe di testo denominate in una tabella hash. Il file test.psd1 si trova nella sottodirectory en-US della directory C:\Test che contiene lo script.

Nella seconda parte dell'esempio viene illustrato il contenuto dello script Test.ps1. Contiene un comando Import-LocalizedData che importa i dati dal file .psd1 corrispondente nella variabile $Messages e un comando Write-Host che scrive uno dei messaggi presenti nella variabile $Messages nel programma host.

Nell'ultima parte dell'esempio viene eseguito lo script. L'output mostra che viene visualizzato il messaggio utente corretto nella lingua dell'interfaccia utente impostata per l'utente corrente del sistema operativo.

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

Descrizione
-----------
In questo esempio viene illustrato come utilizzare Import-LocalizedData per sostituire stringhe di testo predefinite nella sezione DATA di uno script.

In questo esempio, la sezione DATA dello script TestScript.ps1 contiene un comando ConvertFrom-StringData che converte il contenuto della sezione DATA in una tabella hash e archivia il valore della variabile $UserMessages. 

Lo script include anche un comando Import-LocalizedData che importa una tabella hash di stringhe di testo tradotte dal file con TestScript.psd1 nella sottodirectory specificata dal valore della variabile $PsUICulture. Se il comando trova il file con estensione psd1, salva le stringhe tradotte nel valore della stessa variabile $UserMessages, sovrascrivendo la tabella hash salvata dalla logica della sezione DATA.

Con il terzo comando viene visualizzato il primo messaggio nella variabile $UserMessages.

Se il comando Import-LocalizedData trova un file con estensione psd1 per la lingua di $PsUICulture, il valore della variabile $UserMessages contiene le stringhe di testo tradotte. Se, per qualsiasi motivo, il comando non riesce, vengono visualizzate le stringhe di testo predefinite specificate della sezione DATA dello 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

Descrizione
-----------
In questo esempio viene illustrato come eliminare i messaggi di errore visualizzati quando Import-LocalizedData non trova le directory che corrispondono alle impostazioni cultura dell'interfaccia utente specificata o un file con estensione psd1 per lo script in tali directory.

Per eliminare il messaggio di errore, è possibile utilizzare il parametro comune ErrorAction con il valore "SilentlyContinue". Ciò è utile in particolar modo quando sono stati forniti messaggi utente in un'impostazione predefinita o una lingua di fallback e non è necessario alcun messaggio di errore.

In questo esempio vengono confrontati due script, Day1.ps1 e Day2.ps1 che includono un comando Import-LocalizedData. Gli script sono identici, ad eccezione del fatto che Day2 utilizza il parametro comune ErrorAction con il valore SilentlyContinue.

Nell'output di esempio vengono illustrati i risultati dell'esecuzione di entrambi gli script quando le impostazioni cultura dell'interfaccia utente vengono impostate su fr-BE e non sono presenti directory o file corrispondenti per tali impostazioni cultura dell'interfaccia utente. Day1.ps1 visualizza un messaggio di errore e l'output in inglese. Day2.ps1 visualizza solo l'output in inglese.