Compartir a través de

  • Artículo

Remove-CsImFilterConfiguration

 

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

Quita la configuración de filtro de mensajería instantánea (IM) especificada. (La configuración de filtro de mensajería instantánea se usa para evitar que los usuarios envíen mensajes instantáneos que contengan hipervínculos).

Sintaxis

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

Descripción detallada

Al enviar mensajes instantáneos, los usuarios pueden insertar un URI en el texto del mensaje para compartir un sitio web o un recurso compartido determinado con el resto de participantes de la conversación. Microsoft Lync Server 2010 se puede configurar de modo que los hipervínculos que contengan determinados prefijos se bloqueen o no estén activos. (En otras palabras, los participantes no pueden simplemente hacer clic en el vínculo y obtener acceso al sitio al que el URI haga referencia, sino que deben copiar y pegar el vínculo manualmente a un explorador).

El cmdlet Remove-CsImFilterConfiguration quita la configuración de filtro de mensajería instantánea de una identidad especificada (por ejemplo, un sitio específico). Al ejecutar este cmdlet con la identidad Global simplemente se restablecerá la configuración global a los valores predeterminados.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Remove-CsImFilterConfiguration en forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

La identidad única de la configuración que se quitará. La misma será Global o Site:<site name> (donde<site name> representa el nombre del sitio al cual se aplica la configuración).

Tipo de datos completo: Microsoft.Rtc.Management.Xds.XdsIdentity

Force

Opcional

Parámetro modificador

Suprime las solicitudes 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.ImFilterConfiguration. Acepta entradas canalizadas de objetos de configuración de filtro de mensajería instantánea.

Tipos de valores devueltos

Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Ejemplo

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

Remove-CsImFilterConfiguration -Identity site:Redmond

En el ejemplo 1, se usa Remove-CsImFilterConfiguration para quitar la configuración de filtro de mensajería instantánea que tengan un parámetro Identity site:Redmond. Cuando se quita una configuración de filtro de mensajería instantánea de un sitio, éste comienza automáticamente a usar la configuración global en su lugar.

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

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

En el ejemplo 2, se quitan todas las configuraciones de filtros de mensajería instantánea en el ámbito de sitio. Para llevar a cabo esta acción, el comando primero usa Get-CsImFilterConfiguration y el parámetro Filter para devolver todas las configuraciones en el ámbito del sitio; la cadena de comodines site:* indica a Get-CsImFilterConfiguration que solamente devuelva las configuraciones que tengan un parámetro Identity que comience por el valor de cadena site:. La recopilación filtrada de directivas se canaliza luego aRemove-CsImFilterConfiguration, el cual elimina cada configuración de la recopilación.