Export-CsLisConfiguration
Última modificación del tema: 2012-03-23
Exporta una configuración de Enhanced 9-1-1 (E9-1-1) de Enterprise Voice a un archivo en formato comprimido para realizar copias de seguridad.
Sintaxis
Export-CsLisConfiguration -FileName <String>
Export-CsLisConfiguration [-AsBytes <SwitchParameter>]
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 (WAP). Las configuraciones de E9-1-1 incluyen también información sobre los servicios web suministrados por el proveedor de enrutamiento de red de E9-1-1, así como sobre las ubicaciones y las direcciones postales, y si se han comprobado o no. Dado el volumen de información y configuración necesario para implementar E9-1-1, se recomienda realizar copias de seguridad periódicas de toda la configuración. Puede usar este cmdlet para realizar una copia de seguridad de la configuración de E9-1-1 en un archivo, que guardará la configuración completa en formato comprimido. Para recuperar la configuración, llame al cmdlet Import-CsLisConfiguration.
Este cmdlet crea un archivo de copia de seguridad nuevo: no sobrescribirá ningún archivo existente. Esto implica que el nombre de archivo que se especifique en la llamada a este cmdlet no puede ser el nombre de un archivo ya existente.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Export-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 "Export-CsLisConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
FileName |
Requerido |
Cadena de caracteres |
La ruta de acceso y el nombre del archivo en el que desea guardar la configuración. No puede ser el nombre de un archivo ya existente. Si indica un valor para el parámetro AsBytes, no podrá hacerlo para el parámetro FileName. Si obtiene acceso a este cmdlet de forma remota, debe usar AsBytes en lugar de FileName. |
AsBytes |
Opcional |
Parámetro modificador |
Devuelve la configuración en forma de matriz de bytes. El resultado del comando se debe asignar a una variable para importarla posteriormente. (Si no asigna el resultado a una variable, la matriz de bytes que representa la configuración desplazará hacia abajo la ventana de Shell de administración de Lync Server.) No se pueden especificar ambos parámetros (AsBytes y FileName): solo se puede usar uno de ellos para llamar a este cmdlet. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Devuelve una matriz de bytes (Byte[]) cuando se usa el parámetro AsBytes.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Export-CsLisConfiguration -FileName C:\E911Config.bak
En este ejemplo se exporta toda la configuración de E9-1-1 del servidor de información de ubicación (LIS) al archivo de copia de seguridad llamado E911Config.bak.
-------------------------- Ejemplo 2 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
En este ejemplo, la configuración del LIS se almacena como matriz de bytes en una variable, $lisconfig.
-------------------------- Ejemplo 3 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
$lisconfig | 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 ubicaciones.