Compartir a través de

  • Artículo

Get-CsImFilterConfiguration

 

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

Devuelve los filtros de vínculo de mensajería instantánea (IM) configurados en la organización. Estos filtros se usan para impedir que los usuarios envíen mensajes instantáneos que contengan hipervínculos con prefijos específicos (por ejemplo, vínculos con un prefijo http o telnet). En función de la configuración, esto significa que cualquier identificador uniforme de recursos (URI) cuyo prefijo sea uno de estos esquemas se convertirá en un hipervínculo en el que no se pueda hacer clic o se quitará.

Sintaxis

Get-CsImFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsImFilterConfiguration [-Filter <String>] [-LocalStore <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 e ir al sitio al que refiera el URI; deben copiar y pegar el vínculo manualmente en un explorador).

El cmdlet Get-CsImFilterConfiguration recupera toda la configuración relativa al filtrado de URI de los mensajes instantáneos. Get-CsImFilterConfiguration se llama a sí mismo (sin parámetros) y devuelve toda la configuración de filtros de mensajería instantánea de URI, de forma global y para todos los sitios. También es posible especificar una identidad para mostrar la configuración de un sitio específico (o la configuración global).

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsImFilterConfiguration: RTCUniversalUserAdmins, 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 "Get-CsImFilterConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la configuración que se desea recuperar. El valor será global o site:<nombre_sitio>, donde <nombre_sitio> es el nombre del sitio al que se aplica la configuración, como site:Redmond.

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

Filter

Opcional

Cadena de caracteres

Realiza una búsqueda con caracteres comodín para las configuraciones que coinciden con un patrón de identidad específico. Por ejemplo, devuelve todas las opciones con identidades que comiencen por site* (todas las opciones específicas del sitio).

LocalStore

Opcional

Parámetro modificador

Recupera la configuración de filtros de mensajería instantánea de la réplica local del Almacén de administración central, en lugar de recuperarla del propio Almacén de administración central.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Get-CsImFilterConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Ejemplo

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

Get-CsImFilterConfiguration

El comando que se muestra arriba devuelve una colección de todos los filtros de hipervínculo de mensajería instantánea configurados para su uso en la organización. Es el comportamiento predeterminado cada vez que se llama a Get-CsImFilterConfiguration sin ningún parámetro adicional.

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

Get-CsImFilterConfiguration -Identity site:Redmond

El ejemplo anterior devuelve la configuración de un filtro de mensajería instantánea: la configuración que tiene la identidad site:Redmond. Dado que las identidades deben ser únicas, este comando nunca devolverá más de una configuración.

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

Get-CsImFilterConfiguration -Filter site:*

El Ejemplo 3 usa el parámetro Filter para devolver una colección de todos los filtros de mensajería instantánea que se han configurado en el nivel del sitio. La cadena de caracteres comodín site:* indica a Get-CsImFilterConfiguration que devuelva únicamente las configuraciones de filtros de mensajería instantánea que tengan una identidad que comience con el valor de cadena site:.

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

(Get-CsImFilterConfiguration -Identity Global).Prefixes

En el Ejemplo 4, el valor de la propiedad Prefixes de la configuración de filtros de mensajería instantánea global se "expande" cuando se muestra en pantalla. Esto significa simplemente que la propiedad y sus valores se muestran con un formato más fácil de usar y leer para el usuario. Para llevar a cabo esta tarea, Get-CsImFilterConfiguration se usa en primer lugar para recuperar la configuración de filtros de mensajería instantánea global. (Tenga en cuenta que la llamada a Get-CsImFilterConfiguration se incluye entre paréntesis. Eso indica a Windows PowerShell que primero debe ejecutar el comando entre paréntesis y luego seguir con los demás). Después de recuperar una configuración, se muestra el valor de la propiedad Prefixes con un prefijo en cada línea.