Compartir a través de

  • Artículo

New-CsFileTransferFilterConfiguration

 

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

Crea una nueva configuración del filtro de transferencia de archivos. Las configuraciones del filtro de transferencia de archivos se usan 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

New-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 se puede configurar para que los archivos con determinadas extensiones (por lo general, extensiones de tipos de archivos que sean potencialmente peligrosos) no se puedan enviar mediante un cliente de Lync Server 2010.

Cuando instala Lync Server 2010, se crea automáticamente una única configuración de filtro de transferencia de archivos (que se configura en el ámbito global). De forma predeterminada, esas configuraciones globales se aplican a todos los usuarios en su organización. Asimismo, puede usar el cmdlet New-CsFileTransferFilterConfiguration para crear configuraciones personalizadas de filtro de transferencia de archivos para sitios individuales. Si una configuración existe para un sitio determinado, esas configuraciones de transferencia de archivos se aplicarán a todos los usuarios en ese sitio. Si no existe dicha recopilación para un sitio, entonces las configuraciones globales se aplicarán en su lugar.

Tenga en cuenta que no puede crear nuevas configuraciones de transferencia de archivos en el ámbito global. Sin embargo, puede usar el cmdlet Set-CsFileTransferFilterConfiguration para modificar configuraciones globales. Asimismo, no puede crear una nueva configuración para un sitio que ya tiene una configuración definida. Si intenta eso, el comando generará un error.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsFileTransferFilterConfiguration localmente: RTCUniversalServerAdministrator. 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 "New-CsFileTransferFilterConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único que debe otorgarse a la configuración de filtros de transferencia de archivos. El parámetro Identity para la nueva configuración es simplemente el prefijo "site:" seguido del nombre del sitio. Por ejemplo, para crear una nueva configuración para el sitio Redmond, se debe usar esta sintaxis: -Identity site:Redmond.

Action

Opcional

Cadena de caracteres

Determina la acción que debe llevarse a cabo en caso de que el filtro de transferencia de archivos esté habilitado. Si se establece en BlockAll, entonces todas las transferencias de archivos se prohibirán, independientemente de la extensión del archivo. Si se establece en Block (el valor predeterminado), se permitirán las transferencias de archivos a menos que la extensión de archivo se asemeje a uno de los tipos de archivos prohibidos enumerados 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 la extensión del archivo), configure en False el valor de la propiedad Enabled de esta directiva.

Enabled

Opcional

Booleano

Habilita o deshabilita el filtro de transferencia de archivos. Si este parámetro se configura en el valor True, los archivos con extensiones especificadas (o todos los archivos, según el valor de la propiedad Action) no se pueden transferir por medio de un cliente de Lync Server 2010. Si este parámetro es establece en False, se puede transferir cualquier archivo.

Valor predeterminado: True.

Extensions

Opcional

Modificador de lista PS

La lista de las 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á. La lista se ignora si se establece Action en BlockAll (se bloquean todas las transferencias de archivos) o si Enabled se establece en False (no se bloquean las transferencias de archivos).

En forma predeterminada, las siguientes extensiones de archivos se incluyen en 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 solicitudes de confirmación que, de lo contrario, se mostrarí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

New-CsFileTransferFilterConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Ejemplo

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond

En el comando anterior, New-CsFileTransferFilterConfiguration se usa para crear una nueva configuración de filtro de transferencias de archivos de mensajes instantáneos con el parámetro Identity site:Redmond. Debido a que no se especificaron parámetros adicionales, esta configuración se creará usando los valores predeterminados.

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

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

En este comando, New-CsFileTransferFilterConfiguration se usa para crear nuevas configuraciones de filtro de transferencias de archivos con el parámetro Identity site:Redmond. Debido a que se ha especificado el parámetro Extensions, la nueva configuración contendrá todos los valores predeterminados más una extensión de archivo adicional: .ps1. Esta nueva extensión se agrega usando el parámetro Extensions y el modificador de lista Add, seguido de la extensión de archivo que debe agregarse. (Tenga en cuenta que debe incluir el punto como parte de la extensión del archivo). A fin de agregar varias extensiones de archivos, simplemente, separe esas extensiones por medio de comas: @{Add=".ps1",".ps2",".ps3"}

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Replace=".vbs",".ps1"}

En el Ejemplo 3, New-CsFileTransferFilterConfiguration se usa para crear nuevas configuraciones de filtro de transferencias de archivos con el parámetro Identity site:Redmond. Este ejemplo es similar el Ejemplo 2, excepto que se ha usado el modificador del lista Replace, en lugar del modificador Add. Esto significa que el conjunto completo de extensiones de archivo se reemplazará con las dos extensiones de archivo especificadas: .vbs y .ps1. En este caso, los únicos archivos bloqueados en el sitio Redmond serán .vbs y .ps1.

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

$x = New-CsFileTransferFilterConfiguration -Identity site:Redmond -InMemory 
$x.Action = "BlockAll"
Set-CsFileTransferFilterConfiguration -Instance $x

El Ejemplo 4 demuestra el uso del parámetro InMemory para crear una configuración de filtro de transferencia de archivos que inicialmente resida sólo en la memoria. Para llevar a cabo esta acción, el primer comando en el ejemplo usa New-CsFileTransferFilterConfiguration y el parámetro InMemory, a fin de crear una nueva configuración de filtro de transferencia de archivos con el parámetro Identity site:Redmond. En este momento, las nuevas configuraciones existen solo en la memoria; los usuarios en el sitio Redmond aún estarán regidos por las configuraciones de filtro de transferencia de archivos globales.

En el segundo comando, el valor de la propiedad Action para esta instancia en memoria se establece en BlockAll. Finalmente, el tercer comando en el ejemplo usa Set-CsFileTransferFilterConfiguration para crear la nueva recopilación de configuraciones y aplicarlas al sitio Redmond.

Tenga en cuenta que esta misma tarea puede llevarse a cabo en un sólo paso con el siguiente comando:

New-CsFileTransferFilterConfiguration -Identity site:Redmond –Action "BlockAll"