Compartir a través de

  • Artículo

New-CsArchivingConfiguration

 

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

Crea un nuevo conjunto de configuraciones de archivado de mensajería instantánea (IM). Estas configuraciones se pueden usar para habilitar o deshabilitar el guardado automático de sesiones de mensajería instantánea; estas configuraciones, también, permiten bloquear todos los mensajes instantáneos que no se pueden archivar.

Sintaxis

New-CsArchivingConfiguration -Identity <XdsIdentity> [-ArchiveDuplicateMessages <$true | $false>] [-BlockOnArchiveFailure <$true | $false>] [-CachePurgingInterval <UInt32>] [-Confirm [<SwitchParameter>]] [-EnableArchiving <None | ImOnly | ImAndWebConf>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-KeepArchivingDataForDays <UInt32>] [-PurgeExportedArchivesOnly <$true | $false>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Muchas organizaciones encuentran útil mantener una transcripción de todas las sesiones de mensajería instantánea llevadas a cabo por los usuarios. Para otras organizaciones, es obligatorio mantener dichas transcripciones; por ejemplo, a muchas organizaciones del mundo de las finanzas, la ley les solicita que guarden copias de todas las comunicaciones electrónicas.

Microsoft Lync Server 2010 ofrece funciones flexibles para archivar sesiones de mensajería instantánea y conferencias web. Si ha implementado Servidor de archivado, puede usar los diferentes cmdlets CsArchivingConfiguration para habilitar y deshabilitar el archivado de sesiones de mensajería instantánea y para administrar la base de datos de archivado. También puede suspenderse la mensajería instantánea si no es posible archivar el contenido; de este modo se garantiza el control de todas las comunicaciones electrónicas.

Cuando instala Lync Server 2010, una recopilación de configuraciones de archivado globales se crearán por usted; estas configuraciones se aplican en toda la organización de manera predeterminada. De lo contrario, puede usar el cmdlet New-CsArchivingConfiguration para crear una configuración personalizada sitio por sitio.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Único identificador que se va a asignar a la recopilación nueva de las opciones de configuración de archivado. Como solo puede crear nuevas colecciones en el ámbito del sitio, la Identidad siempre será el prefijo "site:" seguido del nombre del sitio; por ejemplo, "site:Redmond".

ArchiveDuplicateMessages

Opcional

Booleano

Especifica cómo se deben archivar mensajes instantáneos entre grupos. Por ejemplo, Ken Myer (con cuenta en el Grupo 1) envía un mensaje instantáneo a Pilar Ackerman (que tiene una cuenta en el Grupo 2). Pilar, a su vez, envía un mensaje una respuesta al mensaje instantáneo de Ken. Si ArchiveDuplicateMessages se establece en False, entonces, (de acuerdo con un algoritmo integrado) la transcripción de la sesión se registrará en el Grupo 1 o en el Grupo 2, pero no en los dos. Si ArchiveDuplicateMessages se define en True (el valor predeterminado), la transcripción se registrará en ambos grupos.

BlockOnArchiveFailure

Opcional

Booleano

Si se establece en True, el servicio de mensajería instantánea se suspenderá cada vez que las sesiones de mensajes instantáneos no se puedan archivar. Si se define en False (el valor predeterminado), la mensajería instantánea continuará incluso si las sesiones no se pueden archivar.

CachePurgingInterval

Opcional

Integer

Indica la frecuencia (en horas) con la que se purgan las transcripciones del sistema en el que ninguno de los participantes fueron habilitados para el archivado. Por diseño, todas las sesiones de mensajería instantánea grupal y de conferencia se registran en el momento que suceden. En el intervalo especificado, el sistema determinará si algunos de los participantes de esas sesiones ha sido habilitado para archivado. Si el sistema encuentra una sesión en la que no se habilitó a ninguno de los participantes para archivado, esa transcripción se eliminará de la base de datos.

La propiedad CachePurgeInterval puede establecerse en cualquier valor entero entre 4 y 168, inclusive. El valor predeterminado es 24.

EnableArchiving

Opcional

Cadena de caracteres

Indica qué elemento (si hay alguno) se guarda en la base de datos de archivado. Los valores válidos son:

None. Ningún elemento se archiva en la base de datos. Es el valor predeterminado.

ImOnly. Las sesiones de mensajería instantánea se archivan en la base de datos.

ImAndWebConf. Las sesiones de mensajería instantánea y de conferencias web se archivan en la base de datos.

EnablePurging

Opcional

Booleano

Si se establece en True, los mensajes instantáneos archivados se quitarán frecuentemente de la base de datos, siempre que estos mensajes instantáneos: 1) sean más antiguos que el valor especificado en la propiedad KeepArchivingDataForDays; o 2) se hayan exportado y marcado para su eliminación.

Si se define en False, los mensajes instantáneos no se eliminarán automáticamente de la base de datos.

KeepArchivingDataForDays

Opcional

Integer

Cantidad de días (entre 1 y 2562) que los mensajes instantáneos archivados se guardan en la base de datos antes de que se eliminen automáticamente. El valor predeterminado es 14.

Esta propiedad solo tiene efecto si EnablePurging se estableció en True.

PurgeExportedArchivesOnly

Opcional

Booleano

Si se define en True, el sistema solo purgará mensajes instantáneos que se hayan exportado (y, en consecuencia, que se hayan marcado para la eliminación). Los mensajes instantáneos que no se hayan exportado permanecerán en la base de datos; aun si esos mensajes son más antiguos que el valor especificado en la propiedad KeepArchivingDataForDays.

PurgeHourOfDay

Opcional

Integer

Indica la hora del día en el que los registros expirados se eliminan de la base de datos de archivado. La hora del día se especifica con un reloj de 24 horas; 0 representa la medianoche (12:00 a. m.) y 23 representa las 11:00 p. m. Tenga en cuenta que solo puede especificar la hora del día. Esto significa que puede programar un purgado para que se realice a las 4:00 a. m., pero, por ejemplo, no puede programarlo para las 4:30 a. m. o 4:15 a. m. El valor predeterminado es 2 (2:00 a. m.).

El purgado de base de datos se produce solo si la propiedad EnablePurging se establece en True.

Force

Opcional

Parámetro modificador

Evita que se muestre cualquier mensaje de error no grave que pueda surgir cuando se ejecuta el comando.

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. New-CsArchivingConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

New-CsArchivingConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Ejemplo

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

New-CsArchivingConfiguration -Identity site:Redmond -EnableArchiving "ImOnly"

El comando que se muestra en el Ejemplo 1 crea una nueva recopilación de configuraciones de archivado y las aplica a Redmond site. Si se agrega el parámetro EnableArchiving y se define el valor del parámetro en "ImOnly", el comando también permite el archivado de sesiones de mensajería instantánea (pero no el archivado de conferencia web) para Redmond site.

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

$x = New-CsArchivingConfiguration -Identity site:Redmond -InMemory
$x.EnableArchiving = "ImOnly"
Set-CsArchivingConfiguration -Instance $x

El ejemplo anterior demuestra el uso del parámetro InMemory para crear una recopilación de configuraciones de archivado que, en principio, solo existe en la memoria. Para hacerlo, el ejemplo crea una nueva recopilación de configuraciones (con la Identidad site:Redmond) y almacena esta recopilación en una variable denominada $x. Tenga en cuenta que, después de que este primer comando se ejecute, la recopilación solo existe en la memoria; si ejecuta el comando Get-CsArchivingConfiguration, no verá ninguna entrada para site:Redmond.

En el segundo comando, la propiedad EnableArchiving para esta recopilación de opciones de configuración virtual se define en "ImOnly", que habilita el archivado de sesión de mensajería instantánea. Finalmente, el último comando usa Set-CsArchivingConfiguration para transformar la configuración de archivado virtual en una recopilación de configuraciones aplicadas a Redmond site. Si no llama a Set-CsArchivingConfiguration, estas configuraciones permanecerán solo en la memoria y desaparecerán cuando finalice la sesión de Windows PowerShell o se elimine la variable $x.