Remove-CsImFilterConfiguration
上次修改主題的時間： 2012-03-27
移除指定的立即訊息 (IM) 篩選組態。(IM 篩選設定用來防止使用者傳送包含超連結的立即訊息)。
語法
Remove-CsImFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
傳送立即訊息時，使用者可以在該訊息的文字中內嵌一個統一資源識別項 (URI)，讓交談中的其他參與者參考特定的網站或共用。您可以設定 Microsoft Lync Server 2010，以封鎖或停用具有特定首碼的超連結 (換句話說，參與者無法只是按一下連結，就被帶往 URI 所指的任何地方；他們必須手動將連結複製並貼入瀏覽器)。
Remove-CsImFilterConfiguration 指令程式會移除指定之身分識別 (例如特定網站) 的 IM 篩選組態。針對 Global Identity 執行此指令程式只會將通用組態重設為預設設定。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsImFilterConfiguration指令程式：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsImFilterConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別 |
要移除之組態的唯一識別身分。這將是 Global 或 Site:<site name> (其中 <site name> 表示要套用設定之網站的名稱)。 完整資料類型：Microsoft.Rtc.Management.Xds.XdsIdentity |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 物件。接受管線傳送的 IM 篩選組態物件輸入。
傳回類型
移除 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsImFilterConfiguration -Identity site:Redmond
在範例 1 中，Remove-CsImFilterConfiguration 用來移除 Identity 為 site:Redmond 的 IM 篩選組態。從網站移除 IM 篩選組態時，該網站會自動開始使用在其位置的通用設定。
-------------------------- 範例 2 --------------------------
Get-CsImFilterConfiguration -Filter site:* | Remove-CsImFilterConfiguration
在範例 2 中，移除網站範圍內的所有 IM 篩選組態。為了執行此作業，命令先使用 Get-CsImFilterConfiguration 和 Filter 參數，傳回網站範圍內的所有組態；萬用字元字串 site:* 則告知 Get-CsImFilterConfiguration 只傳回 Identity 開頭為字串值 site: 的組態。然後，篩選過的原則集合會傳送到 Remove-CsImFilterConfiguration，以刪除集合中的每一個組態。