Import-LocalizedData

El cmdlet Import-LocalizedData recupera dinámicamente cadenas de un subdirectorio cuyo nombre coincide con el idioma de la interfaz de usuario establecido para el usuario actual del sistema operativo. Está diseñado para permitir que los scripts muestren mensajes de usuario en el idioma de la interfaz de usuario seleccionado por el usuario actual.

Import-LocalizedData importa datos de .psd1 archivos en subdirectorios específicos del lenguaje del directorio de scripts y los guarda en una variable local especificada en el comando . El cmdlet selecciona el subdirectorio y el archivo en función del valor del $PSUICulture variable automática. Cuando se usa la variable local en el script para mostrar un mensaje de usuario, el mensaje aparece en el idioma de la interfaz de usuario del usuario.

Puede usar los parámetros de Import-LocalizedData para especificar una referencia cultural de interfaz de usuario alternativa, una ruta de acceso y un nombre de archivo, para agregar comandos compatibles y para suprimir el mensaje de error que aparece si no se encuentran los archivos de .psd1.

El cmdlet Import-LocalizedData admite la iniciativa de internacionalización de scripts que se introdujo en Windows PowerShell 2.0. Esta iniciativa pretende servir mejor a los usuarios en todo el mundo, ya que facilita la visualización de los mensajes de usuario en el idioma de la interfaz de usuario del usuario actual. Para obtener más información sobre esto y sobre el formato de los archivos .psd1, vea about_Script_Internationalization.

En este ejemplo se importan cadenas de texto en la variable $Messages. Usa los valores predeterminados de todos los demás parámetros de cmdlet.

Import-LocalizedData -BindingVariable "Messages"

Si el comando se incluye en el script de Archives.ps1 en el directorio C:\Test y el valor de la variable automática $PSUICulture es zh-CN, Import-LocalizedData importa el archivo Archives.psd1 en el directorio C:\test\zh-CN en la variable $Messages.

Este ejemplo se ejecuta en la línea de comandos que no está en un script. Obtiene cadenas de datos localizadas del archivo Test.psd1 y las muestra en la línea de comandos. Dado que el comando no se usa en un script, se requiere el parámetro FileName. El comando usa el parámetro UICulture para especificar la referencia cultural en-US.

Import-LocalizedData -FileName "Test.psd1" -UICulture "en-US"

Name           Value
----           -----
Msg3           "Use $_ to represent the object that's being processed."
Msg2           "This command requires the credentials of a member of the Administrators group on the...
Msg1           "The Name parameter is missing from the command."

Import-LocalizedData devuelve una tabla hash que contiene las cadenas de datos localizadas.

Import-LocalizedData -BindingVariable "MsgTbl" -UICulture "ar-SA" -FileName "Simple" -BaseDirectory "C:\Data\Localized"

Este comando importa cadenas de texto en la variable $MsgTbl de un script.

Usa el parámetro UICulture para dirigir el cmdlet para importar datos del archivo Simple.psd1 en el subdirectorio ar-SA de C:\Data\Localized.

En este ejemplo se muestra cómo usar datos localizados en un script sencillo.

PS C:\> # 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's being processed."
'@

# In C:\Test\Test.ps1

Import-LocalizedData -BindingVariable "Messages"
Write-Host $Messages.Msg2

# In Windows PowerShell

PS C:\> .\Test.ps1

This command requires the credentials of a member of the Administrators group on the computer.

La primera parte del ejemplo muestra el contenido del archivo Test.psd1. Contiene un comando ConvertFrom-StringData que convierte una serie de cadenas de texto con nombre en una tabla hash. El archivo Test.psd1 se encuentra en el subdirectorio en-US del directorio C:\Test que contiene el script.

La segunda parte del ejemplo muestra el contenido del script de Test.ps1. Contiene un comando Import-LocalizedData que importa los datos del archivo de .psd1 coincidente en la variable $Messages y un comando Write-Host que escribe uno de los mensajes de la variable $Messages en el programa host.

La última parte del ejemplo ejecuta el script. La salida muestra que muestra el mensaje de usuario correcto en el idioma de la interfaz de usuario establecido para el usuario actual del sistema operativo.

En este ejemplo se muestra cómo usar Import-LocalizedData para reemplazar las cadenas de texto predeterminadas definidas en la sección DATA de un script.

PS C:\> # 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...

En este ejemplo, la sección DATA del script de TestScript.ps1 contiene un comando ConvertFrom-StringData que convierte el contenido de la sección DATA en una tabla hash y almacena en el valor de la variable $UserMessages.

El script también incluye un comando Import-LocalizedData, que importa una tabla hash de cadenas de texto traducidas del archivo TestScript.psd1 en el subdirectorio especificado por el valor de la variable $PSUICulture. Si el comando encuentra el archivo .psd1, guarda las cadenas traducidas del archivo en el valor de la misma variable de $UserMessages, sobrescribiendo la tabla hash guardada por la lógica de sección DATA.

El tercer comando muestra el primer mensaje de la variable $UserMessages.

Si el comando Import-LocalizedData busca un archivo .psd1 para el idioma $PSUICulture, el valor de la variable $UserMessages contiene las cadenas de texto traducidas. Si se produce un error en el comando por cualquier motivo, el comando muestra las cadenas de texto predeterminadas definidas en la sección DATA del script.

En este ejemplo se muestra cómo suprimir los mensajes de error que aparecen cuando Import-LocalizedData no pueden encontrar los directorios que coinciden con la referencia cultural de la interfaz de usuario del usuario o no pueden encontrar un archivo .psd1 para el script en esos directorios.

PS C:\> # In Day1.ps1

Import-LocalizedData -BindingVariable "Day"

# In Day2.ps1

Import-LocalizedData -BindingVariable "Day" -ErrorAction:SilentlyContinue

PS C:\> .\Day1.ps1
Import-LocalizedData : Can't 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

PS C:\> .\Day2.ps1
Today is Tuesday

Puede usar el ErrorAction parámetro común con un valor de SilentlyContinue para suprimir el mensaje de error. Esto resulta especialmente útil cuando se han proporcionado mensajes de usuario en un idioma predeterminado o de reserva, y no se necesita ningún mensaje de error.

En este ejemplo se comparan dos scripts, Day1.ps1 y Day2.ps1, que incluyen un comando Import-LocalizedData. Los scripts son idénticos, salvo que Day2 usa el ErrorAction parámetro común con un valor de SilentlyContinue.

La salida de ejemplo muestra los resultados de ejecutar ambos scripts cuando la referencia cultural de la interfaz de usuario está establecida en fr-BE y no hay archivos o directorios coincidentes para esa referencia cultural de interfaz de usuario. Day1.ps1 muestra un mensaje de error y una salida en inglés. Day2.ps1 solo muestra la salida en inglés.

None

No se pueden canalizar objetos a este cmdlet.

Hashtable

Este cmdlet guarda la tabla hash en la variable especificada por el valor del parámetro BindingVariable.

• Antes de usar Import-LocalizedData, localice los mensajes de usuario. Dé formato a los mensajes de cada configuración regional (referencia cultural de la interfaz de usuario) en una tabla hash de pares clave-valor y guarde la tabla hash en un archivo con el mismo nombre que el script y una extensión de nombre de archivo .psd1. Cree un directorio en el directorio de script para cada referencia cultural de interfaz de usuario compatible y, a continuación, guarde el archivo .psd1 para cada referencia cultural de la interfaz de usuario en el directorio con el nombre de referencia cultural de la interfaz de usuario.

  Por ejemplo, localice los mensajes de usuario para la de-DE configuración regional y dé formato a ellos en una tabla hash. Guarde la tabla hash en un archivo <ScriptName>.psd1. A continuación, cree un subdirectorio de-DE en el directorio script y guarde el archivo <ScriptName>.psd1 alemán en el subdirectorio de-DE. Repita este método para cada configuración regional que admita.

• Import-LocalizedData realiza una búsqueda estructurada de los mensajes de usuario localizados para un script.

  Import-LocalizedData comienza la búsqueda en el directorio donde se encuentra el archivo de script (o el valor del parámetro BaseDirectory). A continuación, busca en el directorio base un subdirectorio con el mismo nombre que el valor de la variable $PSUICulture (o el valor del parámetro UICulture), como de-DE o ar-SA. A continuación, busca en ese subdirectorio un archivo de .psd1 con el mismo nombre que el script (o el valor del parámetro FileName ).

  Si Import-LocalizedData no encuentra un subdirectorio con el nombre de la referencia cultural de la interfaz de usuario o el subdirectorio no contiene un archivo .psd1 para el script, busca un archivo .psd1 para el script en un subdirectorio con el nombre del código de idioma, como de o ar. Si no encuentra el subdirectorio o .psd1 archivo, se produce un error en el comando, los datos se muestran en el idioma predeterminado del script y se muestra un mensaje de error que explica que no se pudieron importar los datos. Para suprimir el mensaje y generar errores correctamente, use el ErrorAction parámetro común con un valor de SilentlyContinue.

  Si Import-LocalizedData encuentra el subdirectorio y el archivo .psd1, importa la tabla hash de los mensajes de usuario en el valor del parámetro BindingVariable en el comando . A continuación, cuando se muestra un mensaje de la tabla hash en la variable , se muestra el mensaje localizado.

  Para obtener más información, vea about_Script_Internationalization.