Remove-CsLisPort
上次修改主題的時間： 2012-03-27
移除位置資訊伺服器 (LIS) 連接埠和位置之間的關聯。此位置關聯在增強型 9-1-1 (E9-1-1) Enterprise Voice 實作中，用於通知緊急服務接線生來電者的位置。
語法
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
詳細描述
增強型 9-1-1 讓緊急電話接線員不必詢問來電者的位置資訊，就能找出來電者的位置。當來電者是從 Voice over Internet Protocol (VoIP) 連線撥話時，必須根據各種連線係數來擷取該資訊。VoIP 系統管理員必須設定位置對應圖 (稱做接線圖) 來判定來電者的的位置。此指令程式會從位置組態資料庫移除連接埠，藉以移除實際位置和連接埠之間的關聯，而通話是透過此關聯傳送。
移除連接埠位置並不會移除連接埠的實際位置，它只是移除連接埠。若要移除位置，請呼叫 Remove-CsLisLocation 指令程式。移除連接埠不會同時移除含有指定 ChassisID 的交換器；若要移除交換器，請呼叫 Remove-CsLisSwitch 指令程式。
如果您要移除的連接埠不存在，就不會有任何動作，您也不會收到錯誤或警告訊息。
誰可以執行此 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 連接埠物件輸入。
傳回類型
這個指令程式不會傳回值。它會移除 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 連接埠 (請注意，值為 1 的 PortIDSubType 會轉換為 InterfaceAlias 的值。這個參數和值也可以輸入如下：-PortIDSubType InterfaceAlias)
如果此連接埠與某個位置關聯，該位置不會被移除，只會從位置對應中移除此連接埠。
-------------------------- 範例 2 --------------------------
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
此範例會移除所有無門牌號碼的連接埠位置。範例首先呼叫 Get-CsLisPort 指令程式，這會傳回所有 LIS 連接埠位置的集合。接著將此集合傳送給 Where-Object 指令程式，由其尋找集合中 HouseNumber 屬性空白 (就是 HouseNumber 等於 (-eq) 空字串 (“”) 的項目。最後，我們將這個無門牌號碼的連接埠位置集合傳送給 Remove-CsLisPort 指令程式，以移除此集合中的每個項目。
請注意，如範例 1 所示，不會從位置組態資料庫中移除任何位置，只有參考這些位置的連接埠會被移除。在此狀況下，這表示在位置資料庫中會出現應該要移除的無效位置 (它們無效是因為 HouseNumber 是位置的必要屬性)。您可以呼叫 Remove-CsLisLocation 指令程式來移除這些位置。