Remove-CsImFilterConfiguration

Syntax

Remove-CsImFilterConfiguration
      [-Identity] <XdsIdentity>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

The Remove-CsImFilterConfiguration cmdlet removes the IM filter configuration for a specified identity (such as a specific site). Running this cmdlet against the Global identity will simply reset the global configuration to the default settings.

Examples

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

Remove-CsImFilterConfiguration -Identity site:Redmond

In Example 1, the Remove-CsImFilterConfiguration cmdlet is used to remove the IM filter configuration with the Identity site:Redmond. When an IM filter configuration is removed from a site, that site will automatically begin using the global settings in its place.

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

Get-CsImFilterConfiguration -Filter site:* | Remove-CsImFilterConfiguration

In Example 2, all the IM filter configurations at the site scope are removed. To carry out this task, the command first uses the Get-CsImFilterConfiguration cmdlet and the Filter parameter to return all the configurations at the site scope; the wildcard string site:* tells the Get-CsImFilterConfiguration cmdlet to return only those configurations that have an Identity that begins with the string value site:. The filtered collection of configurations is then piped to the Remove-CsImFilterConfiguration cmdlet, which deletes each configuration in the collection.

Parameters

-Confirm

-Force

-Identity

-WhatIf

Inputs

Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration object. Accepts pipelined input of IM filter configuration objects.

Outputs

Removes an object of type Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Related Links

• New-CsImFilterConfiguration
• Set-CsImFilterConfiguration
• Get-CsImFilterConfiguration