[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Imports an Enterprise Voice Enhance 911 (E9-1-1) configuration from a backup file.

Syntax

Import-CsLisConfiguration -FileName <String>
Import-CsLisConfiguration -ByteInput <Byte[]>

Parameters

Parameter Required Type Description

ByteInput

Required

Byte[]

The value passed to this parameter is a variable containing a byte array of the LIS configuration that was created by the Export-CsLisConfiguration cmdlet with the AsBytes parameter.

FileName

Required

String

The name of the backup file from which to import the configuration. You cannot specify a FileName and a ByteInput. Only one of these two parameters can be used with each call to this cmdlet.

Detailed Description

Implementing E9-1-1 in an enterprise can, depending on the size of the enterprise, involve mapping thousands of subnets, ports, switches, and wireless access points to locations. An E9-1-1 configuration also includes information about web services provided by the E9-1-1 Network Routing Provider, and about locations and civic addresses and whether or not they’ve been validated. Given the volume of information and settings required to implement E9-1-1, it’s highly recommended that you regularly back up the entire configuration. You can backup the entire E9-1-1 configuration to a file by calling the Export-CsLisConfiguration cmdlet. Calling Import-CsLisConfiguration will restore the configuration from that file.

Restoring the configuration by calling this cmdlet will not overwrite the existing configuration. It will insert information that has been removed, but it will not remove existing records that were added after the backup file was created.

IMPORTANT. The fact that the import from backup will not replace existing records means that any records that have been changed will be restored and you’ll have one old instance and one new instance. For example, suppose you’ve defined a wireless access point with a Location value of Building30/Room10. You call Export-CsLisConfiguration to back up your configuration. Later, you modify the Location property of that wireless access point to Building30/Rooms20-40. If you then call Import-CsLisConfiguration to restore the backed-up configuration, you’ll have two entries for that wireless access point: the modified entry with the location Building30/Rooms20-40 and the restored entry with the location Building30/Room10.

Return Types

This cmdlet does not return a value.

Examples

-------------------------- Example 1 --------------------------

Copy Code
Import-CsLisConfiguration -FileName C:\E911Config.bak

This example exports the entire E9-1-1 configuration from the Location Information Server (LIS) to the backup file named E911Config.back.

-------------------------- Example 2 --------------------------

Copy Code
$lisconfig = Export-CsLisConfiguration -AsBytes 
Import-CsLisConfiguration -ByteInput $lisconfig

Example 2 demonstrates how to use the ByteInput parameter of the Import-CsLisConfiguration cmdlet. Line 1 shows a call to the Export-CsLisConfiguration cmdlet with the AsBytes parameter. The output of the command is a byte array containing the LIS configuration. This array is assigned to the variable $lisconfig. In line 2 the Import-CsLisConfiguration cmdlt is called. The ByteInput parameter receives a value of $lisconfig, which is the variable containing the byte array we exported. This will import that byte array back into the LIS configuration.