Parameters

When sending instant messages, users can embed a URI within the text of that message to refer other participants in the conversation to a particular web site or share. Microsoft Lync Server 2010 can be configured so that hyperlinks with certain prefixes are blocked or are not active. (In other words, the participants can’t simply click on the link and be taken to the site the URI refers to; they must copy and paste the link manually into a browser.)

The Get-CsImFilterConfiguration cmdlet retrieves all the settings for filtering URIs from instant messages. Called by itself (with no parameters), Get-CsImFilterConfiguration returns all URI IM filter settings, globally and for all sites. You can also specify an Identity to show the settings for a specific site (or the global settings).

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsImFilterConfiguration cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsImFilterConfiguration"}

None.

Get-CsImFilterConfiguration returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration object.

-------------------------- Example 1 --------------------------

	Copy Code
Get-CsImFilterConfiguration

The command shown above returns a collection of all the IM hyperlink filters configured for use in your organization. This is the behavior any time you call Get-CsImFilterConfiguration without any additional parameters.

-------------------------- Example 2 --------------------------

	Copy Code
Get-CsImFilterConfiguration -Identity site:Redmond

The preceding example returns settings for one IM filter: the settings that have the Identity site:Redmond. Because identities must be unique, this command can never return more than one configuration.

-------------------------- Example 3 --------------------------

	Copy Code
Get-CsImFilterConfiguration -Filter site:*

Example 3 uses the Filter parameter to return a collection of all the IM filters that have been configured at the site level. The wildcard string site:* instructs Get-CsImFilterConfiguration to return only those IM filter configurations that have an Identity that begins with the string value site:.

-------------------------- Example 4 --------------------------

	Copy Code
(Get-CsImFilterConfiguration -Identity Global).Prefixes

In Example 4 the value of the global IM filter configuration’s Prefixes property is "expanded" when displayed on the screen; this simply means that the property and its values are shown in a more user-friendly and readable format. To perform this task, Get-CsImFilterConfiguration is first used to retrieve the global IM filter configuration. (Note that the call to Get-CsImFilterConfiguration is enclosed in parentheses. That tells Windows PowerShell to first carry out the command enclosed in parentheses, and then continue on from there.) After the configuration has been retrieved, the value of the Prefixes property is displayed with one prefix on each line.

Other Resources