Set-CsImFilterConfiguration
上次修改主題的時間： 2012-03-26
修改現有的立即訊息 (IM) 篩選組態。IM 篩選設定可用來預防使用者傳送含作用中 (可點擊) 超連結的立即訊息。
語法
Set-CsImFilterConfiguration [-Identity <XdsIdentity>] [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]
Set-CsImFilterConfiguration [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Instance <PSObject>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
傳送立即訊息時，使用者可以在該訊息的文字中內嵌統一資源識別元 (URI)，讓交談中的其他參與者參考特定的網站或共用。您可以設定 Microsoft Lync Server 2010，以封鎖或停用具有特定首碼的超連結 (換句話說，參與者無法只是按一下連結，就前往 URI 所指的任何站台；他們必須手動將連結複製並貼入瀏覽器)。
Set-CsImFilterConfiguration 指令程式可讓您修改要篩選的 URI 前置字元清單，還能讓您一併啟用或停用全域或特定站台內的篩選功能。您也可以利用這個指令程式，來更新各種提供使用者警告的訊息。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsImFilterConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsImFilterConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
要修改之 IM 篩選器組態設定的唯一識別碼。這個值是 global 或 site:<站台名稱>，其中 <站台名稱> 代表套用設定的站台，如 site:Redmond。 |
Instance |
選用 |
ImFilterConfiguration |
允許您將物件參考傳遞給指令程式，而非設定個別的參數值。這個指令程式可接受屬於 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 類型的物件，其可藉由呼叫 Get-CsImFilterConfiguration 指令程式來加以擷取。 |
Action |
選用 |
UrlFilterAction |
當立即訊息中包含超連結時，這個參數值會決定將採取的動作。 允許 - 將含有底線的超連結加入前置字元，使連結不再為使用中的連結。除此之外，如果訊息是指定在 AllowMessage 內容中，則該訊息會插入在每個含有超連結之立即訊息的開頭。 封鎖 - 封鎖包含有效超連結的訊息傳遞，Lync Server 2010 傳送錯誤訊息給傳送者。 警告 - 將包含使用中的超連結的訊息傳遞給接收參與者，同時在該訊息的開頭插入警告訊息。可使用 WarnMessagehe 屬性來指定警告訊息。如果指定警告但沒有輸入 WarnMessage，雖然仍接受 BlockFileExtension 屬性的設定，IM 篩選還是會停用。 |
AllowMessage |
選用 |
字串 |
如果已指定此參數的值，當 Action 屬性的值設為「允許」時，每一個包含超連結的訊息開頭都會插入該字串。您可以使用此訊息通知使用者，例如按一下不明連結的潛在危險，或組織的相關原則和需求。 |
BlockFileExtension |
選用 |
布林值 |
如果此參數設為 True，則會封鎖包含 Extensions 屬性所指定之副檔名 (定義在 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 類別中) 的檔案路徑之超連結 (透過呼叫 Get-CsFileTransferFilterConfiguration 指令程式擷取)，並將錯誤訊息傳回給傳送者。如果將此參數設為 False，則不會針對檔案路徑和副檔名進行任何特殊檢查。 預設值：True |
Enabled |
選用 |
布林值 |
啟用或停用此功能。如果此參數設為 True，則會掃描超連結的立即訊息，並且套用這個組態內的規則。如果此參數設為 False，則不會檢查超連結的訊息。 預設值：True |
IgnoreLocal |
選用 |
布林值 |
此參數值控制是否執行立即訊息中傳遞的近端內部網路 URI 的篩選。如果此參數設為 True，本機電腦內部網路區域上定義的所有 URI 都會被忽略(本機電腦為執行 IM 篩選應用程式的 前端伺服器)。如果此參數設為 False，會套用指定的篩選至所有超連結。 預設值：True |
Prefixes |
選用 |
PSListModifier |
將篩選 URI 前置字元的清單。依據指定的設定來篩選立即訊息中，含有與清單內其中一個前置字元相符之前置字元的超連結。 預設值：callto:, file:, ftp., ftp:, gopher:, href, http:, https:, ldap:, mailto:, news:, nntp:, sip:, sips:, tel:, telnet:, www*。 |
WarnMessage |
選用 |
字串 |
此參數包含警告訊息，當 Action 屬性的值設為「警告」時，該訊息會插入在含有超連結的每一個立即訊息的開頭。通常此訊息是用來陳述點選不明連結的潛在危險，或組織的相關原則和需求。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 物件。接受管線傳送的 IM 篩選組態物件輸入。
傳回類型
Set-CsImFilterConfiguration 不會傳回值或物件。反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsImFilterConfiguration -Identity site:Redmond -Enabled $False
此範例所示的命令可停用 Identity 為 site:Redmond 之 IM 篩選器組態的 URI 篩選功能。為了執行此作業，我們在 Set-CsImFilterConfiguration 指令程式的呼叫中指定 Enabled 參數，並指定 $False 的值。
-------------------------- 範例 2 --------------------------
$x = Get-CsImFilterConfiguration -Identity site:Redmond
$x.Prefixes.Add("urn:")
Set-CsImFilterConfiguration -Instance $x
上述這組命令可將 URI 前置詞 (urn:)新增至 site:Redmond 之 IM 篩選組態所禁止的前置詞清單中。若要新增前置詞，可使用 Get-CsImFilterConfiguration 指令程式來擷取 site:Redmond 的組態，而代表該組態的回傳物件會儲存在名為 $x 的變數中。擷取設定後，我們在第二行呼叫 Add() 方法以將 urn:新增至儲存在 Prefixes 屬性中的前置詞組合。這會變更物件參照 $x 的值。為了變更實際的組態，我們在第三行呼叫 Set-CsImFilterConfiguration 指令程式，單獨以參數值形式傳遞 $x。
-------------------------- 範例 3 --------------------------
Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="urn:"}
範例 3 執行的動作和範例 2 完全相同，差別在於範例 3 只以一行完成所有動作。在此命令中，Set-CsImFilterConfiguration 指令程式的 -Prefixes 參數可用來將 urn:新增至前置詞清單中。add 清單修飾詞可用來將這個值新增至 Prefixes 清單中。
-------------------------- 範例 4 --------------------------
Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="urn:"}
在此範例中，我們將前置詞 urn:移出 site:Redmond 之 IM 篩選組態所封鎖的前置詞清單之外。除了呼叫 add 清單修飾詞將前置詞新增至清單中和呼叫 remove 修飾詞移除前置詞之外，此範例和範例 3 相同。