EXAMPLE 1

In Example 1, the Remove-CsFileTransferFilterConfiguration cmdlet is used to remove the file transfer filter configuration that has the Identity site:Redmond.

	Copy Code
Remove-CsFileTransferFilterConfiguration -Identity site:Redmond

EXAMPLE 2

In 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.

	Copy Code
Get-CsFileTransferFilterConfiguration -Filter site:* | Remove-CsFileTransferFilterConfiguration

EXAMPLE 3

Example 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.

	Copy Code
Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False} | Remove-CsFileTransferFilterConfiguration

When sending instant messages, users can attach and send files to the other participants in the conversation. Lync 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 Lync 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.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Remove-CsFileTransferFilterConfiguration cmdlet locally: 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 "Remove-CsFileTransferFilterConfiguration"}

Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration object. Accepts pipelined input of file transfer filter configuration objects.

This cmdlet does not return a value or object. Instead, it removes instances of the Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration object.