Set-CsLisSubnet
上一次修改主题： 2012-03-27
创建位置信息服务器 (LIS) 子网，创建子网与位置（如果该位置不存在，则创建一个新位置）之间的关联，或修改现有子网及其关联的位置。在实现增强型 9-1-1 (E9-1-1) 企业语音的过程中使用子网和位置之间的关联，以向紧急服务接线员报告呼叫者的位置。
语法
Set-CsLisSubnet -Subnet <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSubnet -Subnet <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSubnet -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
通过增强型 9-1-1，紧急接线员不必向呼叫者询问其位置即可确定该信息。当呼叫者通过 IP 电话 (VoIP) 连接进行呼叫时，必须根据各种连接因素提取该信息。VoIP 管理员必须配置用于确定呼叫者位置的位置映射（称为线路映射）。通过此 cmdlet，管理员可以将物理位置映射到客户端通过其进行连接的子网。
Subnet 参数是此 cmdlet 的唯一必需参数。如果输入一个已存在的子网值，则此 cmdlet 将根据所提供的位置参数更新该子网的位置。如果该子网不存在，则将会创建一个新的子网位置。
如果位置数据库中不存在地址与此处输入的地址参数（包括空值）完全匹配的位置，则将基于通过此 cmdlet 输入的参数创建新的地址。（可以通过调用 Get-CsLisLocation cmdlet 检索位置列表。）Set-CsLisSubnet cmdlet 不需要或不会提示输入位置参数，因此您可以创建一个子网条目，不必将该条目与某个位置关联。使用此 cmdlet 还可能创建无效位置。有效位置至少需包含 Location、HouseNumber、StreetName、City、State 以及 Country。如果不提供所有这些参数，则从指定子网发出的呼叫可能不包含紧急服务接线员所需的信息（这取决于是否为可用于替换子网设置的交换机、端口或无线访问点提供了有效的设置）。建议尽可能地具体化位置参数，并填写尽可能多的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsLisSubnet cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisSubnet"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Subnet |
必需 |
字符串 |
子网的 IP 地址。该值应以 IPv4 地址形式输入（数字由句点分隔，例如 192.0.2.0）。 |
City |
可选 |
字符串 |
该位置所在的城市。 最大长度：64 个字符。 |
CompanyName |
可选 |
字符串 |
此位置的公司名称。 最大长度：60 个字符 |
Country |
可选 |
字符串 |
该位置所在的国家/地区。 最大长度：2 个字符 |
Description |
可选 |
字符串 |
此子网位置的详细描述。 |
HouseNumber |
可选 |
字符串 |
位置的门牌号。对于公司，这是该公司所在位置的街道号。 最大长度：10 个字符 |
HouseNumberSuffix |
可选 |
字符串 |
门牌号的其他信息，比如 1/2 或 A。例如，1234 1/2 Oak Street 或 1234 A Elm Street。 注意：要指定公寓号或办公房间，必须使用 Location 参数。例如，-Location "Suite 100/Office 150"。 最大长度：5 个字符 |
Location |
可选 |
字符串 |
此位置的名称。该值通常是比市政地址更具体的位置名称，例如办公室编号，但也可能是任意字符串值。 最大长度：20 个字符 |
PostalCode |
可选 |
字符串 |
与该位置关联的邮政编码。 最大长度：10 个字符 |
PostDirectional |
可选 |
字符串 |
街道名称的方向标识。例如，NE 或 NW，或者 Main Street NE 或 7th Avenue NW。 最大长度：2 个字符 |
PreDirectional |
可选 |
字符串 |
街道名称前面的街道名称方向标识。例如，NE 或 NW 分别代表 NE Main Street 或 NW 7th Avenue。 最大长度：2 个字符 |
State |
可选 |
字符串 |
与该位置关联的州或省。 最大长度：2 个字符 |
StreetName |
可选 |
字符串 |
该位置的街道名称。 最大长度：60 个字符 |
StreetSuffix |
可选 |
字符串 |
街道名称中指定的街道类型，例如 Street、Avenue 或 Court。 最大长度：10 个字符 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
接受通过管道传递的 LIS 子网对象的输入。
返回类型
此 cmdlet 创建或修改 System.Management.Automation.PSCustomObject 类型的对象。
示例
-------------------------- 示例 1 --------------------------
Set-CsLisSubnet -Subnet 192.10.10.0
示例 1 创建或更新 LIS 子网位置条目。此示例中的命令仅包含一个（必需）参数：Subnet。此示例中 Subnet 的值是一个 IPv4 地址：192.10.10.0。
请注意，此示例不包含任何地址信息。可以在位置信息服务器上创建一个子网条目，不必将该条目与某个地址关联。但是，通过此子网路由的紧急呼叫可能不（取决于定义的端口或交换机位置）包含紧急服务接线员确定位置所需的足够信息。
重要说明：如果具有此 Subnet 值的 LIS 子网位置已存在，则此位置将会被该命令中的值替换。这意味着，如果此子网与某个地址（物理位置）关联，则该关联将不再存在，这是因为该命令中未包含任何位置信息。该位置仍将存在于位置数据库中，但不再与此子网关联。