Compartir a través de

  • Artículo

Remove-CsFileTransferFilterConfiguration

 

Última modificación del tema: 2012-03-25

Quita la configuración de filtro para la transferencia de archivos de mensajería instantánea. (La configuración de filtro para la transferencia de archivos de mensajería instantánea se usa para bloquear la capacidad de un usuario para transferir determinados tipos de archivos en un mensaje instantáneo.)

Sintaxis

Remove-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Al enviar mensajes instantáneos, los usuarios pueden adjuntar y enviar archivos al resto de participantes de la conversación. Microsoft Lync Server 2010 se puede configurar para que los archivos con determinadas extensiones (por lo general extensiones de tipos de archivos que sean potencialmente peligrosos) no se puedan enviar mediante un cliente de Lync Server 2010.

El cmdlet Remove-CsFileTransferFilterConfiguration permite eliminar una configuración de filtro para la transferencia de archivos. En el caso de las configuraciones del ámbito del sitio, Remove-CsFileTransferFilterConfiguration quitará la configuración; a su vez, los usuarios del sitio heredarán automáticamente la configuración global de filtro para la transferencia de archivos. Remove-CsFileTransferFilterConfiguration también se puede ejecutar en la configuración global. No obstante, en este caso no se quitará la configuración global, sino que todos los valores de las propiedades de dicha configuración se restablecerán a los valores predeterminados.

Quien puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsFileTransferFilterConfiguration de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de configuración para la transferencia de archivos que se va a quitar. Para hacer referencia a la configuración global, use esta sintaxis: -Identity global. Para hacer referencia a una configuración en el ámbito del sitio, use una sintaxis similar a ésta: -Identity site:Redmond. Tenga en cuenta que no puede usar valores de caracteres comodín para especificar una identidad.

Force

Opcional

Parámetro modificador

Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration. Acepta datos transferidos de los objetos de configuración de filtros para la transferencia de archivos.

Tipos de valores devueltos

Este cmdlet no devuelve un objeto o valor. En su lugar, quita instancias el objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Remove-CsFileTransferFilterConfiguration -Identity site:Redmond

En el ejemplo anterior, se usa Remove-CsFileTransferFilterConfiguration para quitar la configuración de filtro para la transferencia de archivos con el valor de Identity site:Redmond.

-------------------------- Ejemplo 2 --------------------------

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

En el ejemplo 2 se quitan todas las configuraciones para la transferencia de archivos del ámbito del sitio. Para realizar esta tarea, el comando primero usa Get-CsFileTransferFilterConfiguration y el parámetro Filter para devolver todas las configuraciones del ámbito del sitio. El valor del filtro "site:*" indica a Get-CsFileTransferFilterConfiguration que devuelva solo las configuraciones cuya identidad comienza con el valor de cadena "site:". A continuación, la colección filtrada de configuraciones se transfiere a Remove-CsFileTransferFilterConfiguration, que elimina todos los elementos de la colección.

-------------------------- Ejemplo 3 --------------------------

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

En el ejemplo 3 se muestra cómo puede quitar todas las configuraciones de filtro para la transferencia de archivos que estén actualmente deshabilitadas. Para ello, el comando primero usa Get-CsFileTransferFilterConfiguration para devolver una colección de todas las configuraciones de filtro para la transferencia de archivos que estén actualmente en uso en la organización. A continuación, esta información se transfiere al cmdlet Where-Object, que únicamente selecciona las colecciones de configuraciones de transferencia de archivos cuya propiedad Enabled sea igual a (-eq) False ($False). Por último, la colección filtrada se transfiere a Remove-CsFileTransferFilterConfiguration, que quita todos los elementos de la colección filtrada.