Compartir a través de

  • Artículo

New-CsImFilterConfiguration

 

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

Crea una nueva configuración del filtro de mensajería instantánea (MI). Los filtros de MI sirven para evitar que los usuarios envíen mensajes instantáneos con hipervínculos activos.

Sintaxis

New-CsImFilterConfiguration -Identity <XdsIdentity> [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-InMemory <SwitchParameter>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-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 en un explorador).

El cmdlet New-CsImFilterConfiguration permite al usuario definir una lista de prefijos URI que se filtrarán (así como habilitar y deshabilitar el filtrado en general) en un sitio específico. Si se llama a New-CsImFilterConfiguration con un único parámetro Identity especificado, se creará una nueva configuración con dicha identidad, y se rellenará la lista de prefijos de ese sitio con un conjunto de prefijos predeterminados que se filtrarán.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsImFilterConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Un identificador único que identifica el ámbito de la configuración del filtro de mensajería instantánea. La configuración global existe de manera predeterminada y no puede volver a crearse con el cmdlet New-CsImFilterConfiguration, si bien el usuario puede crear configuraciones de nivel del sitio especificando un parámetro Identity igual a site:<site name>, donde <site name> es el nombre del sitio al que se aplicará la configuración (por ejemplo, site:Redmond).

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

Action

Opcional

UrlFilterAction

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

Permitir: los hipervínculos van precedidos de un carácter de subrayado de modo que ya no estén activos. Si se especifica un mensaje en la propiedad AllowMessage, éste se podrá insertar 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.

Advertencia: los mensajes que contienen hipervínculos activos se entregan a los participantes receptores, junto con un mensaje de advertencia que se inserta al principio de dichos mensajes. El mensaje de advertencia puede especificarse con la propiedad WarnMessage. Si se especifica Advertencia y no se introduce ningún WarnMessage, el filtrado de mensajería instantánea se inhabilitará, aunque la configuración de la propiedad BlockFileExtension se seguirá teniendo en cuenta.

Valor predeterminado: Permitir, a menos que un mensaje contenga más de 1.000 URL, en cuyo caso la opción predeterminada será Bloquear.

Tipo de datos completo: Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.UrlFilterAction

AllowMessage

Opcional

Cadena de caracteres

Si se especifica un valor para este parámetro, esa cadena se insertará al principio de todos los mensajes que contengan hipervínculos cuando el valor de la propiedad Action esté establecido en Allow. Puede usar este mensaje para informar a los usuarios de 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á establecido en True, se bloquearán los hipervínculos que contengan una ruta de acceso de archivo con una extensión especificada mediante la propiedad Extensions definida en la configuración de filtro de transferencia de archivo aplicable (que se puede obtener llamado al cmdlet Get-CsFileTransferFilterConfiguration) y el remitente recibirá un mensaje de error. Si este parámetro está establecido en False, no se realizará ninguna comprobación especial de las extensiones de archivo.

Valor predeterminado: True

Enabled

Opcional

Booleano

Habilita o inhabilita esta característica. Si este parámetro está establecido en True, se examinarán los mensajes instantáneos para comprobar si contienen hipervínculos y se aplicarán las reglas establecidas en esta configuración. Si este parámetro está establecido en False, no se comprobará si los mensajes contienen hipervínculos.

Valor predeterminado: True

IgnoreLocal

Opcional

Booleano

El valor de este parámetro controla si el filtrado se lleva a cabo en las URI de Intranet locales enviadas en los mensajes instantáneos. Si este parámetro está establecido en True, se ignorarán todas las URI definidas en la zona de Intranet del equipo local. (El equipo local es el Servidor front-end que ejecuta la aplicación de filtro de MI.) Si este parámetro está establecido 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án. Todos los hipervínculos incluidos en un mensaje instantáneo que tengan un prefijo que coincida con uno de los prefijos de esta 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 los mensajes instantáneos que incluyen hipervínculos cuando el valor de la propiedad Action está establecido en Warn (Advertencia). 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 las preguntas de confirmación que aparecerían antes de realizar cambios.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno.

Tipos de valores devueltos

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

Ejemplo

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

New-CsImFilterConfiguration -Identity site:Redmond

En el comando que se muestra arriba, New-CsImFilterConfiguration se usa para crear una nueva configuración de filtrado de MI con el valor de Identity site:Redmond. Como no se especifican parámetros adicionales, estas opciones se crearán con los valores predeterminados.

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

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="rtsp:","urn:"}

En este comando, New-CsImFilterConfiguration se usa para crear una nueva configuración de filtrado de MI con el valor de Identity site:Redmond. Como se ha especificado el parámetro Prefixes, la nueva configuración incluirá todos los valores predeterminados, incluidos los prefijos predeterminados del filtrado, más dos prefijos de URI adicionales: rtsp: y urn:. Estos prefijos se agregan utilizando el modificador de la lista de adiciones para agregar estos prefijos a la lista predeterminada.

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

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{replace="rtsp:","urn:"}

En este comando, New-CsFileTransferFilterConfiguration se usa para crear una nueva configuración de filtrado de MI con el valor de Identity site:Redmond. Este ejemplo es similar al Ejemplo 2, salvo que se ha utilizado el modificador de la lista de sustituciones en lugar del modificador de la lista de adiciones. Esto significa que todos los prefijos de URI predeterminados se sustituirán por estos dos prefijos (rtsp: y urn:). Por consiguiente, sólo se filtrarán los URI con prefijos de rtsp: o urn: en los mensajes instantáneos para el sitio Redmond.