Remove-CsLisPort
上一次修改主题： 2012-03-27
删除位置信息服务器 (LIS) 端口与位置之间的关联。此关联在增强型 9-1-1 (E9-1-1) 企业语音实现中用于向紧急服务接线员通知呼叫者的位置。
语法
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
通过增强型 9-1-1，紧急接线员不必向呼叫者询问其位置即可确定该信息。当呼叫者通过 IP 电话 (VoIP) 连接进行呼叫时，必须根据各种连接因素提取该信息。VoIP 管理员必须配置用于确定呼叫者位置的位置映射（称为线路映射）。通过从位置配置数据库中删除端口，此 cmdlet 可删除物理位置与通过其路由呼叫的端口之间的关联。
删除端口位置不会删除端口的实际位置，而仅删除端口。要删除该位置，请调用 Remove-CsLisLocation cmdlet。删除端口不会同时删除具有给定 ChassisID 的交换机；要删除该交换机，请调用 Remove-CsLisSwitch cmdlet。
如果您尝试删除不存在的端口，将不会执行任何操作，您也不会收到错误或警告消息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsLisPort cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLisPort"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
ChassisID |
必需 |
字符串 |
端口交换机的媒体访问控制 (MAC) 地址。该值的格式将为 nn-nn-nn-nn-nn-nn，例如 12-34-56-78-90-ab。 |
PortID |
必需 |
字符串 |
要删除的端口的 ID。 |
PortIDSubType |
必需 |
PortIDSubType |
要删除的端口的子类型。输入的值可以是数值或字符串，但必须是有效的子类型。有效的子类型包括： 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
接受通过管道传递的 LIS 端口对象的输入。
返回类型
此 cmdlet 不会返回值。它会删除一个类型为 System.Management.Automation.PSCustomObject 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
示例 1 删除 MAC 地址 (ChassisID) 为 99-99-99-99-99-99、PortID 为 4200 且 PortIDSubType 为 1 的 LIS 端口。（请注意，PortIDSubType 的值 1 将转换为 InterfaceAlias 的值。此参数和值也可能已按如下格式输入：-PortIDSubType InterfaceAlias)
如果此端口已与某个位置相关联，则不会删除该位置，而仅从位置映射中删除此端口。
-------------------------- 示例 2 --------------------------
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
此示例删除没有门牌号的所有端口位置。此示例首先调用 Get-CsLisPort cmdlet，以返回所有 LIS 端口的集合。将该集合通过管道传递到 Where-Object cmdlet，后者将找出该集合中 HouseNumber 属性为空（也就是说，HouseNumber 等于 (-eq) 空字符串 ("")）的项。最后，将没有门牌号的端口位置的集合通过管道传递到 Remove-CsLisPort cmdlet，后者将删除该集合中的所有项。
请注意，与示例 1 中相同，不会从位置配置数据库删除任何位置，而只删除引用这些位置的端口。在此示例中，意味着位置数据库中存在应该删除的无效位置（它们之所以无效，是因为 HouseNumber 是位置的必需属性）。您可以通过调用 Remove-CsLisLocation cmdlet 来删除位置。