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.