Import-CsLisConfiguration
Última modificación del tema: 2012-03-23
Importa una configuración de Enterprise Voice Enhanced 9-1-1 (E9-1-1) desde un archivo de copia de seguridad.
Sintaxis
Import-CsLisConfiguration -FileName <String>
Import-CsLisConfiguration -ByteInput <Byte[]>
Descripción detallada
Según cuál sea el tamaño de una organización, la implementación de E9-1-1 puede que implique tener que asignar a las ubicaciones miles de subredes, puertos, conmutadores y puntos de acceso inalámbrico. Una configuración de E9-1-1 incluye información sobre el servidor de información de ubicaciones (LIS) suministrado por el proveedor de enrutamiento de red de E9-1-1, así como sobre las ubicaciones y las direcciones postales y si éstas se han validado o no. Dado el volumen de información y configuración necesario para implementar E9-1-1, se recomienda encarecidamente realizar copias de seguridad periódicas de toda la configuración. Se puede hacer una copia de seguridad de toda la configuración de E9-1-1 en un archivo; para ello, se llama al cmdlet Export-CsLisConfiguration. Al llamar a Import-CsLisConfiguration, se restablece la configuración de dicho archivo.
Restablecer la configuración mediante la ejecución de este cmdlet no sobrescribirá la configuración existente. Introducirá información que se ha eliminado, pero no eliminará los registros existentes, añadidos después de la creación del archivo de copia de seguridad.
IMPORTANTE: Dado que la importación de la copia de seguridad no va a reemplazar los registros existentes, se restaurará cualquier registro que se haya cambiado y podría quedarse con ubicaciones huérfanas. Por ejemplo, suponga que ha definido un punto de acceso inalámbrico (WAP) con un valor de Location de Building30/Room10. Llama a Export-CsLisConfiguration para hacer una copia de seguridad de la configuración. Después, modifica la propiedad Location de dicho punto de acceso inalámbrico a Building30/Rooms20-40. Si, tras ello, llama a Import-CsLisConfiguration para restaurar la configuración de la que se ha hecho una copia de seguridad, la ubicación de ese WAP será Building30/Room10 (que era la ubicación anterior a la copia de seguridad), si bien la ubicación para Building30/Rooms20-40 se conservará en la base de datos de configuración de ubicaciones.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Import-CsLisConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsLisConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
ByteInput |
Requerido |
Byte[] |
El valor pasado a este parámetro es una variable que contiene una matriz de bytes de la configuración de LIS que el cmdlet Export-CsLisConfiguration creó con el parámetro AsBytes. |
FileName |
Requerido |
Cadena de caracteres |
El nombre del archivo de copia de seguridad del que importar la configuración. No puede especificar un FileName y un ByteInput. Sólo podrá usarse uno de estos dos parámetros con cada ejecución de este cmdlet. |
Tipos de entrada
Byte[]. Acepta una matriz de bytes de una configuración de LIS exportada. La matriz de bytes se debe transferir como un único registro. Vea el ejemplo 3.
Tipos de valores devueltos
Este cmdlet no devuelve un valor.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Import-CsLisConfiguration -FileName C:\E911Config.bak
En este ejemplo se importa la configuración de E9-1-1 desde el archivo de copia de seguridad denominado E911Config.back a la base de datos de configuración de ubicaciones.
-------------------------- Ejemplo 2 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
Import-CsLisConfiguration -ByteInput $lisconfig
En el ejemplo 2 se muestra cómo usar el parámetro ByteInput del cmdlet Import-CsLisConfiguration. La línea 1 refleja una llamada al cmdlet Export-CsLisConfiguration con el parámetro AsBytes. El resultado del comando es una matriz de bytes que contiene la configuración LIS. La matriz se asigna a la variable $lisconfig. En la línea 2 se llama al cmdlet Import-CsLisConfiguration. El parámetro ByteInput recibe un valor de $lisconfig, la variable que contiene la matriz de bytes exportada. De este modo, se importará la matriz de bytes de nuevo a la base de datos de configuración de ubicaciones.
-------------------------- Ejemplo 3 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
$listconfig | Set-Content -Path C:\E911Config.bak -Encoding byte
Get-Content -ReadCount 0 -Encoding byte -Path C:\E911Config.bak | Import-CsLisConfiguration
El ejemplo 3 es una versión más completa del ejemplo 2. La primera línea es igual, se llama a Export-CsLisConfiguration con el parámetro AsBytes para almacenar la configuración del LIS como una matriz de bytes en la variable $lisconfig. En la parte restante de este ejemplo se muestra cómo guardar esa configuración en un archivo y después importarla de vuelta en la base de datos de configuración de ubicación.
En la línea 2, se transfiere el contenido de $lisconfig, que es la matriz de bytes que representa la configuración del LIS, al cmdlet Set-Content de Windows PowerShell. Asignamos valores a dos parámetros de Set-Content: Path y Encoding. Asignamos el nombre de archivo y la ruta completa del archivo en el que queremos guardar la configuración para el parámetro Path. Usamos el parámetro Encoding con un valor de byte para asegurarnos de que la configuración se almacena como matriz de bytes.
Por último, en la línea 3, importamos la configuración de nuevo en la base de datos de configuración de ubicación. Primero llamamos a Get-Content para recuperar el contenido del archivo. Pasamos un valor de 0 a la propiedad ReadCount, que hace que Get-Content lea todo el contenido del archivo a la vez, en lugar de línea por línea. Volvemos a usar el parámetro Encoding con un valor de byte para especificar el tipo de datos que leemos del archivo. Para terminar, pasamos el nombre del archivo al parámetro Path. El contenido del archivo que leemos con Get-Content se transfiere al cmdlet Import-CsLisConfiguration, que importa la configuración guardada a la base de datos de configuración de ubicaciones.