Remove-CsFileTransferFilterConfiguration
Removes the specified instant message file transfer filter configuration. (Instant message file transfer filter settings are used to block a user's ability to transfer certain types of files within an instant message.) This cmdlet was introduced in Lync Server 2010.
Syntax
Remove-CsFileTransferFilterConfiguration
[-Identity] <XdsIdentity>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
When sending instant messages, users can attach and send files to the other participants in the conversation. Skype for Business Server can be configured so that files with certain extensions--typically extensions of file types that could potentially prove harmful--are not allowed to be sent using a Skype for Business Server client.
The Remove-CsFileTransferFilterConfiguration cmdlet enables you to delete a file transfer filter configuration.
For configurations at the site scope, the Remove-CsFileTransferFilterConfiguration cmdlet will remove the configuration; in turn, the users on the site will automatically inherit the global file transfer filter configuration.
The Remove-CsFileTransferFilterConfiguration cmdlet can also be run against the global configuration.
In that case, however, the global configuration will not be removed; instead, all the property values in that configuration will be reset to their default values.
Examples
-------------------------- Example 1 --------------------------
Remove-CsFileTransferFilterConfiguration -Identity site:RedmondIn Example 1, the Remove-CsFileTransferFilterConfiguration cmdlet is used to remove the file transfer filter configuration that has the Identity site:Redmond.
-------------------------- Example 2 --------------------------
Get-CsFileTransferFilterConfiguration -Filter site:* | Remove-CsFileTransferFilterConfigurationIn Example 2, all the file transfer filter configurations at the site scope are removed.
To carry out this task, the command first uses the Get-CsFileTransferFilterConfiguration cmdlet and the Filter parameter to return all the configurations at the site scope.
The filter value "site:*" tells the Get-CsFileTransferFilterConfiguration 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-CsFileTransferFilterConfiguration cmdlet, which deletes each item in the collection.
-------------------------- Example 3 --------------------------
Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False} | Remove-CsFileTransferFilterConfigurationExample 3 shows you how you can remove all the file transfer filter configurations that are currently disabled.
To do this, the command first uses the Get-CsFileTransferFilterConfiguration cmdlet to return a collection of all the file transfer filter configurations currently in use in the organization.
That information is then piped to the Where-Object cmdlet, which selects only those file transfer filter configurations where the Enabled property is equal to (-eq) False ($False).
That filtered collection is then piped to the Remove-CsFileTransferFilterConfiguration cmdlet, which proceeds to remove each item in the filtered 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
Unique identifier for the file transfer configuration to be removed.
To refer to the global configuration, use this syntax: -Identity global.
To refer to a configuration at the site scope, use syntax similar to this: -Identity site:Redmond.
Note that you cannot use wildcard values when specifying an Identity.
| 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.FileTransferFilterConfiguration object. Accepts pipelined input of file transfer filter configuration objects.
Outputs
This cmdlet does not return a value or object. Instead, it removes instances of the Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration object.