Get-CsImFilterConfiguration
上次修改主題的時間： 2012-03-23
傳回設定於組織中的立即訊息連結 (IM) 篩選。這些篩選會用來防止使用者傳送包含具特定首碼之超連結的立即訊息 (例如，含 http 或 telnet 首碼的連結)。根據您的設定，這表示開頭含有這些架構其中一項的任何統一資源識別項 (URI) 將會轉換成不可點選超連結或一併遭到移除。
語法
Get-CsImFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsImFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
傳送立即訊息時，使用者可以在該訊息的文字中內嵌 URI，讓交談中的其他參與者參考特定的網站或共用。您可以設定 Microsoft Lync Server 2010，以封鎖或停用具有特定首碼的超連結 (換句話說，參與者無法只是按一下連結，就前往 URI 所指的任何站台；他們必須手動將連結複製並貼入瀏覽器)。
Get-CsImFilterConfiguration 指令程式會從立即訊息擷取所有用於篩選 URI 的設定。自行呼叫 (不含任何參數) Get-CsImFilterConfiguration 會傳回所有的 URI IM 篩選設定，通用與所有站台。您也可以指定 Identity，顯示特定站台的設定 (或通用設定)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsImFilterConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsImFilterConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
您要擷取之設定的唯一識別碼。這可為通用或 site:<站台名稱>，其中 <站台名稱> 是這些設定套用的站台名稱，例如 site:Redmond。 完整資料類型：Microsoft.Rtc.Management.Xds.XdsIdentity |
Filter |
選用 |
字串 |
執行符合指定 Identity 模式之組態的萬用字元搜尋。例如，傳回含開頭為 site* (所有特定站台設定) 之識別身分的所有設定。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取 IM 篩選器組態，而不是從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
Get-CsImFilterConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsImFilterConfiguration
上述的命令會傳回已設定用於您組織之所有 IM 超連結篩選的集合。這是呼叫 Get-CsImFilterConfiguration 且不搭配任何其他參數的運作方式。
-------------------------- 範例 2 --------------------------
Get-CsImFilterConfiguration -Identity site:Redmond
上述範例會傳回一個 IM 篩選的設定：Identity 為 site:Redmond 的設定。由於識別身分必須是唯一的，因此這個命令絕對不會傳回一個以上的組態。
-------------------------- 範例 3 --------------------------
Get-CsImFilterConfiguration -Filter site:*
範例 3 會使用 Filter 參數，傳回已在站台層級進行設定之所有 IM 篩選的集合。萬用字元字串 site:* 會指示 Get-CsImFilterConfiguration，僅傳回 Identity 開頭字串值為 site: 的 IM 篩選組態。
-------------------------- 範例 4 --------------------------
(Get-CsImFilterConfiguration -Identity Global).Prefixes
在範例 4 中，當顯示於螢幕上時，通用 IM 篩選組態之 Prefixes 屬性值為 "expanded"；這只是說明屬性及其值會以更為簡易及更易於讀取的格式顯示。若要執行這項工作，先使用 Get-CsImFilterConfiguration 來擷取通用 IM 篩選組態。(請注意，對 Get-CsImFilterConfiguration 的呼叫會以括弧括住。這樣會告知 Windows PowerShell 先執行以括弧括住的命令，然後由此繼續)。擷取組態之後，會在每一行顯示含一個前置字元的 Prefixes 內容值。