Compartir a través de


Set-CsImFilterConfiguration

 

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

Modifica una configuración de filtro de mensajería instantánea (IM) existente. La configuración de filtro de mensajería instantánea se usa para impedir que los usuarios envíen mensajes instantáneos que contengan hipervínculos activos (en los que se pueda hacer clic).

Sintaxis

Set-CsImFilterConfiguration [-Identity <XdsIdentity>] [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Set-CsImFilterConfiguration [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Instance <PSObject>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Al enviar mensajes instantáneos, los usuarios pueden insertar un Identificador de recursos uniforme (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 limitarse a hacer clic en el vínculo e ir al sitio al que refiera el URI; deben copiar y pegar el vínculo de forma manual a un explorador.)

El cmdlet Set-CsImFilterConfiguration permite modificar una lista de prefijos URI que se filtrarán, así como habilitar y deshabilitar el filtrado por completo, globalmente o dentro de un sitio específico. Con este cmdlet también puede actualizar varios mensajes de advertencia a los usuarios.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsImFilterConfiguration de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

El identificador único de las opciones de configuración de filtro de mensajería instantánea que se quieren modificar. Este valor será global o site:<nombre_sitio>, donde <nombre_sitio> es el sitio al que se aplica la configuración, como site:Redmond.

Instance

Opcional

ImFilterConfiguration

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. Este cmdlet acepta un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration, que se puede recuperar llamando al cmdlet Get-CsImFilterConfiguration.

Action

Opcional

UrlFilterAction

El valor de este parámetro determina la acción que se llevará a cabo cuando se incluya un hipervínculo en un mensaje instantáneo:

Allow: los hipervínculos van precedidos de un carácter de subrayado para que los vínculos dejen de estar activos. Además, si se especifica un mensaje en la propiedad AllowMessage, se inserta un mensaje de notificación al principio de cada mensaje instantáneo que contenga hipervínculos.

Block: se bloquea la entrega de mensajes que contengan hipervínculos activos y Lync Server 2010 envía un mensaje de error al remitente.

Warn: los mensajes que contengan hipervínculos activos se entregan a los participantes receptores, junto con un mensaje de advertencia que se inserta al inicio de dichos mensajes. El mensaje de advertencia puede especificarse mediante la propiedad WarnMessage. Si se especifica Warn y no se introduce ningún mensaje WarnMessage, se deshabilitará el filtrado de mensajería instantánea, a pesar de que la configuración de la propiedad BlockFileExtension se continuará respetando.

AllowMessage

Opcional

Cadena de caracteres

Si se especifica un valor para este parámetro, la cadena de caracteres se insertará al inicio de cada mensaje que contenga hipervínculos siempre que el valor de la propiedad Action esté definido en Allow. Puede usar este mensaje para informar a los usuarios sobre aspectos como los posibles riesgos de hacer clic en vínculos desconocidos o las directivas y los requisitos correspondientes a la organización.

BlockFileExtension

Opcional

Booleano

Si este parámetro está definido en True, se bloquearán los hipervínculos que contengan una ruta de archivo con una extensión especificada mediante la propiedad Extensions definida en la clase Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration (recuperada llamando al cmdlet Get-CsFileTransferFilterConfiguration) y el remitente recibirá un mensaje de error. Si este parámetro está definido en False, no se realizará ninguna comprobación especial para las rutas de archivo y extensiones.

Valor predeterminado: True

Enabled

Opcional

Booleano

Habilita o deshabilita esta característica. Si este parámetro se define en True, se analizarán los mensajes instantáneos en busca de hipervínculos y se aplicarán las reglas incluidas en esta configuración. Si este parámetro se define en False, no se comprobarán los mensajes en busca de hipervínculos.

Valor predeterminado: True

IgnoreLocal

Opcional

Booleano

El valor de este parámetro controla si el filtrado se realiza en los URI de la intranet local enviados en los mensajes instantáneos. Si está definido en True, se omitirán todos los URI que se hayan definido en la zona de intranet del equipo local. (El equipo local es el equipo Servidor front-end que ejecuta la aplicación de filtro de mensajería instantánea.) Si este parámetro está definido en False, el filtrado especificado se aplica a todos los hipervínculos.

Valor predeterminado: True

Prefixes

Opcional

Modificador de lista PS

La lista de prefijos URI que se filtrará. Todos los hipervínculos incluidos en un mensaje instantáneo con un prefijo que coincida con uno de los prefijos de la lista se filtrarán de acuerdo con la configuración especificada.

Valor predeterminado: callto:, file:, ftp., ftp:, gopher:, href, http:, https:, ldap:, mailto:, news:, nntp:, sip:, sips:, tel:, telnet:, www*.

WarnMessage

Opcional

Cadena de caracteres

Este parámetro contiene el mensaje de advertencia que se inserta al principio de todos los mensajes instantáneos que contienen hipervínculos, si el valor de la propiedad Action está definido en Warn. Normalmente, este mensaje se usa para indicar los posibles riesgos de hacer clic en vínculos desconocidos o para hacer referencia a directivas o requisitos relevantes para la organización.

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.ImFilterConfiguration. Acepta la entrada transferida de objetos de configuración de filtro de mensajería instantánea.

Tipos de valores devueltos

Set-CsImFilterConfiguration no devuelve valores ni objetos. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Ejemplo

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

Set-CsImFilterConfiguration -Identity site:Redmond -Enabled $False

El comando mostrado en este ejemplo deshabilita el filtrado URI para la configuración de filtro de IM con la identidad site:Redmond. Para realizar esta tarea, se especifica el parámetro Enabled en la llamada al cmdlet Set-CsImFilterConfiguration con un valor de $False.

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

$x = Get-CsImFilterConfiguration -Identity site:Redmond
$x.Prefixes.Add("urn:")
Set-CsImFilterConfiguration -Instance $x

El conjunto anterior de comandos agrega un prefijo URI nuevo (urn:) a la lista de prefijos prohibidos por la configuración de filtro de IM de site:Redmond. Para agregar el nuevo prefijo, se usa el cmdlet Get-CsImFilterConfiguration para recuperar la configuración de site:Redmond; el objeto devuelto que representa dicha configuración se almacena en una variable denominada $x. Una vez recuperada la configuración, se llama al método Add() en la línea 2 para agregar urn: al conjunto de prefijos almacenados en la propiedad Prefixes. De este forma, se cambia el valor de la referencia al objeto $x. Para cambiar la configuración real, en la línea 3 se llama al cmdlet Set-CsImFilterConfiguration, donde se envía $x como valor único del parámetro.

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

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="urn:"}

En el Ejemplo 3 se realiza la misma acción que en el Ejemplo 2, pero en una sola línea. En este comando el parámetro -Prefixes del cmdlet Set-CsImFilterConfiguration se usa para agregar urn: a la lista de prefijos. El modificador de lista add se usa para agregar este valor a la lista Prefixes.

-------------------------- Ejemplo 4 --------------------------

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="urn:"}

En este ejemplo, el prefijo urn: se quita de la lista de prefijos bloqueados por la configuración de filtro de mensajería instantánea de site:Redmond. Este ejemplo es idéntico al Ejemplo 3, excepto por el hecho que en lugar de llamar al modificador de lista add para agregar un prefijo a la lista, se llama al modificador remove para quitar un prefijo.