Set-CsLisSwitch
上一次修改主题： 2012-04-23
创建位置信息服务器 (LIS) 交换机，创建交换机与位置（如果该位置不存在，则创建一个新位置）之间的关联，或修改现有交换机及其关联的位置。交换机与位置之间的关联在增强型 9-1-1 (E9-1-1) 企业语音实现中用于向紧急服务接线员通知呼叫者的位置。
语法
Set-CsLisSwitch -ChassisID <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-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSwitch -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，管理员可以将物理位置映射到用于连接客户端的网络交换机。
ChassisID 参数是该 cmdlet 所需的唯一参数。如果输入的 ChassisID 值已存在，该 cmdlet 将基于提供的位置参数更新交换机的位置。如果 ChassisID 不存在，将创建新的交换机位置。
如果位置数据库中不存在地址与此处输入的地址参数（包括空值）完全匹配的位置，则将基于通过此 cmdlet 输入的参数创建新的地址。（可以通过调用 Get-CsLisLocation cmdlet 检索位置列表。）Set-CsLisSwitch cmdlet 不要求或提示使用位置参数，您可以创建不与位置相关联的交换机条目。使用此 cmdlet 还可能创建无效位置。有效位置至少需包含 Location、HouseNumber、StreetName、City、State 以及 Country。如果未提供所有这些参数，引用交换机接收的呼叫可能不包含紧急服务接线员所需的信息（取决于是否有可供子网或无线访问点使用的可代替交换机设置的有效设置）。建议尽可能地具体化位置参数，并填写尽可能多的信息。
请注意，还可以通过调用 Set-CsLisPort cmdlet 来创建交换机条目。如果调用带有 ChassisID 值的 Set-CsLisPort 时不存在现有交换机条目，则将创建该交换机。
必须注意，仅当您已经使用 New-CsWebServiceConfiguration 或 Set-CsWebServiceConfiguration cmdlet 配置了 MACResolverUrl 属性时，这些更改才会生效。MACResolverUrl 属性指定一个 Web 服务的 URL，该 Web 服务能够获取某 IP 地址并确定与该 IP 地址关联的网卡的媒体访问控制 (MAC) 地址。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsLisSwitch cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisSwitch"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
ChassisID |
必需 |
字符串 |
网络交换机的媒体访问控制 (MAC) 地址。此值的格式必须是 nn-nn-nn-nn-nn-nn，如 12-34-56-78-90-ab，或使用 IP 地址的格式。如果具有指定 ChassisID 值的条目不存在，将创建新的交换机位置。如果存在具有指定 ChassisID 的条目，将替换该条目。 |
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-CsLisSwitch -ChassisID 99-99-99-99-99-99
示例 1 创建或更新 LIS 交换机位置条目。此示例中的命令仅包含一个（必需）参数：ChassisID。ChassisID 的值是交换机的 MAC 地址，在此示例中是 99-99-99-99-99-99。
请注意，此示例不包含任何地址信息。可以在位置信息服务器上创建不与地址相关联的交换机条目。但是，通过此交换机路由的紧急呼叫所包含的信息可能不足以（取决于定义的子网或端口位置）使紧急服务接线员识别位置。
重要说明：如果具有此 ChassisID 的 LIS 交换机位置已存在，则会将其替换为此命令中的值。这意味着，如果此交换机与某个地址（物理位置）相关联，该关联将不再存在，因为此命令中未包含任何位置信息。该位置仍将存在于位置数据库中，但不与此交换机相关联。
-------------------------- 示例 2 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
示例 2 通过添加地址信息，更新示例 1 中创建的交换机。（这实际上将删除现有条目，并替换为新条目。）如果位置数据库中没有该地址，此 cmdlet 将创建该位置。