Compartir a través de

  • Artículo

Set-CsFileTransferFilterConfiguration

 

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

Modifica una colección de opciones de configuración del filtro de transferencia de archivos. La configuración del filtro de transferencia de archivos se usa para bloquear la capacidad del usuario para transferir ciertos tipos de archivos (por ejemplo, archivos con una extensión de archivo .vbs o .ps1) mediante clientes de Microsoft Lync Server 2010.

Sintaxis

Set-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsFileTransferFilterConfiguration [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Al enviar mensajes instantáneos, los usuarios pueden adjuntar y enviar archivos a los demás participantes de la conversación. Lync Server 2010 puede configurarse de modo que los archivos con ciertas extensiones (normalmente extensiones de tipos de archivo que podrían ser potencialmente peligrosos) no puedan enviarse desde el cliente.

La capacidad de los usuarios para transferir archivos con los clientes de Lync Server 2010 está determinada por las opciones de configuración del filtro de transferencia de archivos aplicadas en los ámbitos global u (opcionalmente) del sitio. El cmdlet Set-CsFileTransferFilterConfiguration permite modificar una configuración de filtro de transferencia de archivos existente. Puede modificar la lista de extensiones que se bloquearán añadiendo o quitando extensiones, o creando una nueva lista general. También se puede utilizar este cmdlet para cambiar si se habilita o no el filtrado de transferencia de archivos, y a qué nivel (bloquear sólo los archivos con extensiones que coincidan con los de la lista de extensiones o bloquear todos los archivos).

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único de la configuración de transferencia de archivos que se quiere modificar. Este valor será global o de sitio:<nombre del sitio>, donde <nombre del sitio> es el nombre del sitio al que se aplicarán las configuraciones, como, por ejemplo, site:Redmond.

Si no se especifica este parámetro, Set-CsFileTransferFilterConfiguration actualizará la configuración global de manera predeterminada.

Instance

Opcional

FileTransferFilterConfiguration

Permite pasar una referencia a un objeto al cmdlet en lugar de establecer valores de parámetro individuales. Este objeto debe ser de tipo FileTransferFilterConfiguration y puede recuperarse si se llama al cmdlet Get-CsFileTransferFilterConfiguration.

Action

Opcional

Cadena de caracteres

Determina la acción que debe tomarse si se habilita esta configuración de filtro de transferencia de archivos. Si se establece en BlockAll, se prohibirán todas las transferencias de archivos, sin importar la extensión del archivo. Si se establece en block (el valor predeterminado), se permitirá la transferencia de archivos a menos que la extensión del archivo aparezca como uno de los tipos de archivo prohibidos que se indican en la propiedad Extensions.

A fin de permitir transferencias de archivos no restringidas (es decir, para permitir que los usuarios intercambien cualquier tipo de archivo, independientemente de su extensión), establezca la propiedad Enabled de esta directiva en False.

Enabled

Opcional

Booleano

Habilita o inhabilita el filtrado de transferencia de archivos. Si este parámetro está establecido en True, los archivos con las extensiones especificadas (o todos los archivos, en función del valor de la propiedad Action) no podrán transferirse desde el cliente. Si este parámetro está establecido en False, podrán transferirse todos los archivos.

Valor predeterminado: True.

Extensions

Opcional

Lista de cadenas

Lista de extensiones de archivo que se bloquearán. Si intenta usar un cliente de Lync Server 2010 para transferir un archivo que tiene una extensión de archivo que coincide con una de las extensiones en esta lista, esa transferencia se bloqueará y el archivo no se transferirá. Esta lista se ignora is Action está establecido en BlockAll (se bloquean todas las transferencias de archivos) o si Enabled está establecido en False (no se bloquea ninguna transferencia).

De manera predeterminada, se incluyen las siguientes extensiones de archivo en el valor predeterminado de la propiedad Extensions: .ade, .adp, .app, .asp, .bas, .bat, .cer, .chm, .cmd, .com, .cpl, .crt, .csh, .exe, .fxp, .grp, .hlp, .hta, .inf, .ins, .isp, .its, .js, .jse, .ksh, .lnk, .mad, .maf, .mag, .mam, .maq, .mar., mas., .mat, .mau, .mav, .maw, .mda, .mdb. .mde, .mdt, .mdw, .mdz, .msc, .msi, .msp, .mst, .ocx, .ops, .pcd, .pif, .pl, .pnp, .prf, .prg, .pst, .reg, .scf, .scr, .sct, .shb, .shs, .tmp, .url, .vb, .vbe, .vbs, .vsd, .vsmacros, .vss, .vst, .vsw, .ws, .wsc. .wsf, .wsh

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerí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.FileTransferFilterConfiguration. Acepta la entrada transferida de objetos de configuración de filtro de transferencia de archivos.

Tipos de valores devueltos

Este cmdlet no devuelve un valor ni un objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Ejemplo

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

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

El comando que se muestra en el Ejemplo 1 deshabilita el filtrado de transferencias de archivos para el sitio Redmond (es decir, la configuración de filtrado de transferencias de archivos que tiene Identity site:Redmond). Para llevar a cabo esta tarea, el parámetro Enabled se incluye en el comando y se establece en $False.

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

Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}

Los comandos anteriores agregan una nueva extensión de archivo (.ps1, que es la extensión de archivo de los scripts de Windows PowerShell) a la lista de extensiones de archivos prohibidas en el sitio Redmond. Para agregar la nueva extensión de archivo, Set-CsFileTransferFilterConfiguration usa el parámetro Extensions y el modificador de la lista de adiciones. El modificador añade la extensión de archivo especificada (.ps1) a la lista de extensiones prohibidas. Para agregar varias extensiones mediante un único comando, simplemente separe las extensiones de archivo con comas: @{Add=".ps1",".ps2",".ps3"}. Tenga en cuenta que se debe incluir el punto al especificar una extensión de archivo.

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

Get-CsFileTransferFilterConfiguration | Set-CsFileTransferFilterConfiguration -Extensions @{Add=".ps1"}

En el ejemplo 3, se agrega la extensión de archivo .ps1 a la lista de extensiones de todas las configuraciones del filtro de transferencia de archivos que hay actualmente en uso en la organización. Para ello, se llama en primer lugar a Get-CsFileTransferFilterConfiguration, sin ningún parámetro adicional, para devolver una colección de todas las configuraciones del filtro de transferencias de archivos que se están usando actualmente. A continuación, dicha colección se transfiere a Set-CsFileTransferFilterConfiguration, que agrega la extensión de archivo .ps1 a cada uno de los elementos de la colección.

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

Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Remove=".ps1"}

En el ejemplo anterior, la extensión de archivo .ps1 se quita de la lista de extensiones bloqueadas por la configuración del filtro de transferencias de archivos para el sitio Redmond. Este ejemplo es idéntico al Ejemplo 3, salvo que en lugar de llamar al modificador de la lista de adiciones para agregar una extensión a la lista, se llama al modificador de la lista de eliminaciones para quitar una extensión de dicha lista.

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

$a = Get-CsFileTransferFilterConfiguration -Identity site:Redmond
$a.Extensions.Remove(".ps1")
Set-CsFileTransferFilterConfiguration -Instance $a

En el ejemplo 5 se realiza la misma acción que en el ejemplo 4; esto es, se quita la extensión .ps1 de la lista de extensiones del filtro de transferencias de archivos para el sitio Redmond. No obstante, en este caso se recupera primero la configuración del filtro de transferencias de archivos para site:Redmond y se asigna la salida a la variable $a. Ahora, $a incluye la configuración para el sitio Redmond. A continuación, se recupera la propiedad Extensions de $a, que es la propiedad Extensions de site:Redmond ($a.Extensions). Esta propiedad incluye la lista de extensiones de archivo. La siguiente propiedad Extensions es una llamada al método Remove ($a.Extensions.Remove). Pasamos el valor .ps1 al método Remove. De este modo, dicha extensión se quitará de la lista de la propiedad Extension. No obstante, solo se ha quitado la extensión de la configuración almacenada en la memoria en la variable $a. Para realizar el cambio en la base de datos es necesario llamar a Set-CsFileTransferFilterConfiguration, pasando $a al parámetro Instance.