Remove-CsTrunkConfiguration
上次修改主題的時間: 2012-03-26
移除現有的主幹組態,此組態會描述主幹對等實體 (例如,服務提供者的公用交換電話網路 (PSTN) 閘道、IP 公用交換機 (PBX) 或工作階段界限控制器 (SBC)) 的設定。
語法
Remove-CsTrunkConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
使用此指令程式移除適用於 PSTN 閘道實體的主幹組態。每個組態均含有主幹對等實體 (例如,服務提供者的 PSTN 閘道、IP-PBX 或 SBC) 的專屬設定。這些設定所設定的項目包括此主幹是否啟用媒體旁路、是否在特定情況下傳送即時傳輸控制通訊協定 (RTCP) 封包,以及是否需要安全即時通訊協定 (SRTP) 加密。
請注意,如果您在通用組態上呼叫 Remove-CsTrunkConfiguration,則不會移除該主幹組態。而是組態會被「重設」,且會以預設值取代所有自訂設定。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsTrunkConfiguration Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrunkConfiguration"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
XdsIdentity |
您要移除之主幹組態的唯一識別碼。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 物件。接受主幹組態物件管線傳送的輸入。
傳回類型
這個指令程式不會傳回值。它會移除 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Remove-CsTrunkConfiguration -Identity site:Redmond
此範例會移除 Identity 為 site:Redmond 的主幹組態。
-------------------------- 範例 2 ------------------------
Get-CsTrunkConfiguration -Filter site:* | Remove-CsTrunkConfiguration
範例 2 會移除在站台層級定義的所有主幹組態。命令的第一部分會呼叫 Get-CsTrunkConfiguration 指令程式,該指令程式會使用 Filter 參數來擷取 Identity 開頭為 site: 的所有主幹組態 (亦即所有在站台層級定義的主幹組態)。此組態集合會被傳送到 Remove-CsTrunkConfiguration 指令程式,移除集合內的每一個物件。