Compartir a través de

  • Artículo

Get-CsFileTransferFilterConfiguration

 

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

Devuelve las opciones de configuración de filtros de transferencia de archivos configurada en su organización. Estas opciones de configuración se usan para bloquear la posibilidad del usuario de transferir ciertos tipos de archivos (por ejemplo, archivos con extensión de archivos .vbs o .ps1) con un cliente Microsoft Lync Server 2010.

Sintaxis

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

Get-CsFileTransferFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Cuando envían mensajes instantáneos, los usuarios pueden adjuntar y enviar archivos a otros participantes de la conversación. Se puede configurar Lync Server 2010 a fin de que los archivos con determinada extensión, generalmente extensiones de tipos de archivos que pudieran ser probados perjudiciales, no puedan ser enviados con el cliente Lync Server 2010.

El cmdlet Get-CsFileTransferFilterConfiguration le proporciona un modo de recuperar la configuración de una recopilación de configuraciones en particular (estas opciones se pueden configurar en el ámbito global o en el ámbito del sitio). Las opciones de configuración de filtros de transferencia de archivos comprenden la lista de extensiones de archivos bloqueadas de transferencias hasta el grado en el que se habilita el filtrado (todas las transferencias de archivos están bloqueadas o solo los archivos con las extensiones especificadas) y si está habilitado el filtrado de transferencia de archivos.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsFileTransferFilterConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsFileTransferFilterConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para la configuración del filtro de transferencia de archivo que desea recuperar. Para hacer referencia a la configuración global, use la siguiente sintaxis: -Identity global. Para hacer referencia a una configuración definida en el ámbito de sitio, use una sintaxis similar a ésta: -Identity site:Redmond. Recuerde que no puede usar valores comodín cuando especifica una identidad. Si desea usar comodines, use en cambio el parámetro Filter.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín al especificar las opciones de configuración de filtro de transferencia de archivo que se devolverán. Por ejemplo, para devolver todas las opciones de configuración de filtro de transferencia de archivo definidas en el ámbito de sitio, use la sintaxis: -Filter "site:*". Por diseño, las opciones de configuración de filtro de transferencia de archivos que tienen una identidad (la única propiedad que se puede filtrar) que comienza con el valor de cadena "site": configuradas en el ámbito del sitio.

LocalStore

Opcional

Parámetro modificador

Recupera la configuración del filtro de transferencia de archivo desde la réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Get-CsFileTransferFilterConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Ejemplo

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

Get-CsFileTransferFilterConfiguration

El comando que se muestra en el ejemplo 1 devuelve una recopilación de todas las opciones de configuración de filtros de transferencia de archivos configuradas para usar en su organización. Es el comportamiento predeterminado para cualquier momento que llame a Get-CsFileTransferFilterConfiguration sin ningún parámetro adicional.

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

Get-CsFileTransferFilterConfiguration -Identity site:Redmond

En el ejemplo anterior se devuelve una única configuración de filtro de transferencia de archivos: la configuración con el valor de Identity site:Redmond. Dado que las identidades deben ser únicas, este comando nunca devolverá más de una configuración.

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

Get-CsFileTransferFilterConfiguration -Filter site:*

En el ejemplo 3 se usa el parámetro Filter para devolver una recopilación de opciones de filtro de transferencia de archivos configuradas a nivel del sitio. El valor del filtro "site:*" le ordena a Get-CsFileTransferFilterConfiguration a devolver solo las opciones de configuración cuya identidad comienza con el valor de cadena "site:".

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

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Extensions -contains ".xls"}

El comando que se muestra en el ejemplo 4 solo devuelve las configuraciones de filtro de transferencia de archivos que contienen .xls en su lista de extensiones de archivos prohibidas. Para ello, primero se usa Get-CsFileTransferFilterConfiguration para devolver una recopilación de todas las opciones de configuración en uso en su organización. La recopilación después se canaliza al cmdlet Where-Object, que aplica un filtro que restringe los datos devueltos a aquellas opciones de configuración donde la propiedad Extensions comprende (-contiene) el valor de cadena ".xls".

-------------------------- Ejemplo 5 --------------------------

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

El comando anterior devuelve todas las opciones de configuración del filtro de transferencia de archivos actualmente deshabilitadas. Para llevar a cabo esta tarea, se usa Get-CsFileTransferFilterConfiguration para devolver una recopilación de todas las opciones de configuración en uso en su organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object que, a su vez, selecciona solo las configuraciones donde la propiedad Enabled es igual a (-eq) True ($True).

-------------------------- Ejemplo 6 --------------------------

Get-CsFileTransferFilterConfiguration -Identity Global | Select-Object -ExpandProperty Extensions

En el ejemplo 6 se muestra una lista completa de las extensiones de archivos prohibidas por la configuración de filtro de transferencia de archivos globales. El comando se inicia con una llamada al cmdlet Get-CsFileTransferFilterConfiguration, en el que se especifica la configuración global. La información devuelta después se canaliza al cmdlet Select-Object, que usa el parámetro ExpandProperty para "expandir" el valor de la propiedad Extensions. Como resultado, se muestra la lista completa de extensiones de archivos en pantalla, con una extensión de archivo por línea.