Import-CsLisConfiguration
上一次修改主题： 2012-03-23
从备份文件中导入增强型 9-1-1 (E9-1-1) 企业语音配置。
语法
Import-CsLisConfiguration -FileName <String>
Import-CsLisConfiguration -ByteInput <Byte[]>
详细说明
根据组织规模，在组织中实现 E9-1-1 可能涉及将成千上万个子网、端口、交换机和无线访问点映射到各个位置。E9-1-1 配置还包含有关由 E9-1-1 网络路由提供商提供的位置信息服务器 (LIS) 的信息、有关各个位置和市政地址的信息，以及这些位置和地址是否已经过验证。鉴于实现 E9-1-1 所需的信息和设置的数量，强烈建议您定期备份整个配置。您可以通过调用 Export-CsLisConfiguration cmdlet 将整个 E9-1-1 配置备份到一个文件中。调用 Import-CsLisConfiguration 将从该文件还原配置。
通过调用此 cmdlet 来还原配置不会覆盖现有配置。此操作将插入已删除的信息，但不会删除在创建备份文件之后添加的现有记录。
重要说明：由于从备份导入不会替换现有记录，因此将还原已更改的所有记录，且将保留孤立位置。例如，假设您已使用 Location 值 Building30/Room10 定义无线访问点 (WAP)。您调用 Export-CsLisConfiguration 备份您的配置。然后，您将该无线访问点的 Location 属性修改为 Building30/Rooms20-40。如果您接下来调用 Import-CsLisConfiguration 来还原备份配置，则该 WAP 的位置将会是 Building30/Room10（备份前的位置），但 Building30/Rooms20-40 的位置仍将保留在位置配置数据库中。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Import-CsLisConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsLisConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
ByteInput |
必需 |
Byte[] |
传递给该参数的值是包含 LIS 配置的一个字节数组，LIS 配置是通过带有 AsBytes 参数的 Export-CsLisConfiguration cmdlet 创建的。 |
FileName |
必需 |
字符串 |
要从中导入配置的备份文件的名称。不能同时指定 FileName 和 ByteInput。每次调用此 cmdlet 时，只能使用上述两个参数之一。 |
输入类型
Byte[]。接受来自已导出 LIS 配置的字节数组。字节数组必须以单个记录形式通过管道传递。请参阅示例 3。
返回类型
此 cmdlet 不会返回值。
示例
-------------------------- 示例 1 --------------------------
Import-CsLisConfiguration -FileName C:\E911Config.bak
此示例将 E9-1-1 配置从名为 E911Config.back 的备份文件导入到位置配置数据库中。
-------------------------- 示例 2 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
Import-CsLisConfiguration -ByteInput $lisconfig
示例 2 演示如何使用 Import-CsLisConfiguration cmdlet 的 ByteInput 参数。第 1 行说明如何调用带有 AsBytes 参数的 Export-CsLisConfiguration cmdlet。该命令输出一个包含 LIS 配置的字节数组。此数组将分配给变量 $lisconfig。第 2 行调用 Import-CsLisConfiguration cmdlt。ByteInput 参数接受值 $lisconfig，该值为包含已导出的字节数组的变量。这会将该字节数组重新导入到位置配置数据库中。
-------------------------- 示例 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
示例 3 是示例 2 的更完整的版本。第 1 行相同，我们调用带有 AsBytes 参数的 Export-CsLisConfiguration，以便将 LIS 配置以字节数组形式存储在变量 $lisconfig 中。此示例的其余部分说明如何将该配置保存到一个文件中，并将其重新导入到位置配置数据库中。
在第 2 行中，我们将 $lisconfig 的内容（即表示 LIS 配置的字节数组）通过管道传递到 Windows PowerShell Set-Content cmdlet。我们将为 Set-Content 的以下两个参数分配相应值：Path 和 Encoding。我们将要在其中保存配置的文件的完整路径和文件名分配给 Path 参数。我们使用具有 byte 值的 Encoding 参数确保将配置存储为字节数组。
最后，在第 3 行中，我们将配置重新导入到位置配置数据库中。首先，我们调用 Get-Content 以从文件中检索内容。我们将值 0 传递给 ReadCount 属性，该属性通知 Get-Content 一次性读取该文件的所有内容，而不是每次读取一行。我们再次使用具有 byte 值的 Encoding 参数指定我们将从文件中读取的数据类型。最后，我们将文件名传递给 Path 参数。我们使用 Get-Content 读取的文件内容将通过管道传递到 Import-CsLisConfiguration cmdlet，而后者又将保存的配置导入到位置配置数据库中。