Remove-CsImFilterConfiguration
Removes the specified instant messaging (IM) filter configuration. (IM filter settings are used to prevent users from sending instant messages that contain hyperlinks.) This cmdlet was introduced in Lync Server 2010.
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:RedmondIn 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-CsImFilterConfigurationIn 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
Prompts you for confirmation before executing the command.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Force
Suppresses any confirmation prompts that would otherwise be displayed before making changes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
The unique identity of the configuration to be removed. This will be either Global or Site:<site name> (where <site name> represents the name of the site to which the settings apply).
Full Data Type: Microsoft.Rtc.Management.Xds.XdsIdentity
| Type: | XdsIdentity |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
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.