Compartir a través de

  • Artículo

Set-CsArchivingConfiguration

 

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

Modifica una recopilación de configuraciones de archivado de mensajería instantánea.

Sintaxis

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

Set-CsArchivingConfiguration [-ArchiveDuplicateMessages <$true | $false>] [-BlockOnArchiveFailure <$true | $false>] [-CachePurgingInterval <UInt32>] [-Confirm [<SwitchParameter>]] [-EnableArchiving <None | ImOnly | ImAndWebConf>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepArchivingDataForDays <UInt32>] [-PurgeExportedArchivesOnly <$true | $false>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Muchas organizaciones consideran que es útil guardar una transcripción de todas las sesiones de mensajería instantánea y conferencias web en las que participan los usuarios. Para otras organizaciones, es obligatorio conservar estas transcripciones; por ejemplo, muchas organizaciones del mundo financiero ley tienen que conservar por ley copias de todas las comunicaciones electrónicas.

Para archivar los mensajes instantáneos, debe configurar por lo menos un Servidor de archivado. Una vez configurado el Servidor de archivado, debe llevar a cabo dos pasos más. Primero, tiene que habilitar el archivado en el ámbito global (para más detalles, consulte el tema de Set-CsArchivingConfiguration). También puede definir una configuración de archivado personalizada para distintos sitios.

En segundo lugar, debe usar las directivas de archivado para indicar los usuarios cuyas sesiones de mensajería instantánea se archivarán. las sesiones de mensajería instantánea no se archivarán a menos que haya una directiva vigente que requiera el archivado.

Al instalar Lync Server 2010, se crea automáticamente una recopilación de opciones de configuración globales de archivado; de forma predeterminada, estas configuraciones se aplicarán a toda la organización. También puede usar el cmdlet New-CsArchivingConfiguration para crear configuraciones personalizadas para cada sitio. En ambos casos, puede usar el cmdlet Set-CsArchivingConfiguration para modificar los valores de propiedad de una recopilación o de una configuración de archivado.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsArchivingConfiguration de manera local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsArchivingConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Representa el identificador único de la recopilación de configuraciones de archivado que se va a modificar. Para modificar la configuración global, no use este parámetro o use la sintaxis siguiente: -Identity global. Para modificar la configuración en el ámbito del sitio, use el prefijo "site:" seguido del nombre del sitio. Por ejemplo: -Identity "site:Redmond".

Instance

Opcional

Objeto ArchivingSettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

ArchiveDuplicateMessages

Opcional

Booleano

Especifica cómo deben archivarse los mensajes instantáneos entre grupos de servidores. Imagine este sencillo ejemplo: Ken Myer (con una cuenta en el Grupo de servidores 1) envía un mensaje instantáneo a Pilar Ackerman (que tiene una cuenta en el Grupo de servidores 2). Pilar, a su vez, responde al mensaje instantáneo de Ken. Si ArchiveDuplicateMessages se define en False, según un algoritmo integrado, la transcripción de la sesión se registrará en el Grupo de servidores 1 o en el Grupo de servidores 2, pero no en ambos. Si ArchiveDuplicateMessages se define en True (el valor predeterminado), la transcripción se registrará en ambos grupos de servidores.

BlockOnArchiveFailure

Opcional

Booleano

Si se define en True, se interrumpirá el servicio de mensajería instantánea siempre que los mensajes instantáneos no se puedan archivar. Si se define en False (el valor predeterminado), no se interrumpirá el servicio de mensajería instantánea, a pesar de que no puedan archivarse los mensajes instantáneos.

CachePurgingInterval

Opcional

Entero

Indica con qué frecuencia (en horas) se purgan las transcripciones del sistema en que ninguno de los participantes se haya habilitado para el archivado. Por diseño, todas las sesiones de mensajería instantánea en grupo y las sesiones de conferencia se registran cuando se efectúan. En el intervalo especificado, el sistema determina si alguno de los participantes de estas sesiones se ha habilitado para el archivado. Si el sistema encuentra una sesión en que ninguno de los participantes se haya habilitado para el archivado, la transcripción pertinente se eliminará de la base de datos.

La propiedad CachePurgeInterval puede definirse en cualquier número entero entre 4 y 168, ambos incluidos. El valor predeterminado es 24.

EnableArchiving

Opcional

Cadena de caracteres

Indica los elementos (si los hay) que se guardan en la base de datos de archivado. Los valores válidos son:

None: Ningún elemento se archiva en la base de datos. Éste 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 define en True, los mensajes instantáneos archivados se quitarán periódicamente de la base de datos, siempre que los mensajes instantáneos: 1) sean más antiguos que el valor especificado en la propiedad KeepArchivingDataForDays o 2) se hayan exportado y marcado para que sean eliminados.

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

KeepArchivingDataForDays

Opcional

Entero

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

Esta propiedad solo surte efecto si EnablePurging se ha definido en True.

PurgeExportedArchivesOnly

Opcional

Booleano

Si se define en True, el sistema solo purgará los mensajes instantáneos que se hayan exportado (y, por tanto, que se hayan marcado para que sean eliminados). Los mensajes instantáneos que no se hayan exportado permanecerán en la base de datos, aunque sean más antiguos que el valor especificado por la propiedad KeepArchivingDataForDays.

PurgeHourOfDay

Opcional

Entero

Indica la hora del día en que se eliminan los registros caducados de la base de datos de archivado. La hora del día se especifica con el formato de 24 horas, donde 0 representa la media noche (12:00 AM) y 23 representa las 11:00 PM. Tenga en cuenta que solo puede especificar la hora del día. Esto significa que puede programar que la depuración tenga lugar a las 4:00 AM pero no puede programar que tenga lugar, por ejemplo, a las 4:30 AM o a las 4:15 AM. El valor predeterminado es 2 (2:00 AM).

La depuración de la base de datos solo se lleva a cabo si la propiedad EnablePurging está definida en True.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan surgir al ejecutar el comando.

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.Archiving.ArchivingSettings. Set-CsArchivingConfiguration acepta datos transferidos de objetos de configuración de archivado.

Tipos de valores devueltos

Set-CsArchivingConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Ejemplo

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

Set-CsArchivingConfiguration -Identity site:Redmond -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

En el ejemplo anterior, se usa Set-CsArchivingConfiguration para modificar dos propiedades de la configuración de archivado que tienen el valor de Identity site:Redmond. En primer lugar, el comando establece la propiedad ArchiveDuplicateMessages en False; esto impide que el servidor archive la misma sesión de mensajería instantánea varias veces. El comando también usa el parámetro KeepArchivingDataForDays para indicar al servidor que conserve los mensajes instantáneos durante 30 días.

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

Get-CsArchivingConfiguration -Filter "site:*" | Set-CsArchivingConfiguration -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

El ejemplo 2 es una variación del comando mostrado en el ejemplo 1: la diferencia es que en este caso se modifican los valores de las propiedades ArchiveDuplicateMessages y KeepArchivingDataForDays para todas las configuraciones de archivado que se hayan definido en el ámbito del sitio. Para llevar a cabo esta tarea, el comando primero usa Get-CsArchivingConfiguration y el parámetro Filter para devolver una recopilación de todas las opciones de configuración de archivado configuradas en el ámbito del sitio; el valor de filtro "site:*" garantiza que solo se devuelvan opciones que tienen un parámetro Identity que comienza por los caracteres "site:". "site:". A continuación, la recopilación filtrada se transfiere a Set-CsArchivingConfiguration, que modifica los dos valores de propiedad de todos los elementos de la recopilación.

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

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "ImAndWebConf"} | Set-CsArchivingConfiguration -EnableArchiving "ImOnly"

En el ejemplo 3, se modifican todas las opciones de configuración de archivado que permiten el archivado de sesiones de mensajería unificada y de conferencias web; una vez completado el comando, estas opciones de configuración solo permitirán el archivado de sesiones de mensajería unificada. Para ello, el comando primero llama a Get-CsArchivingConfiguration sin ningún parámetro para devolver una recopilación de todas las opciones de configuración de archivado que están en uso en la organización. Dicha recopilación se transfiere al cmdlet Where-Object, que únicamente selecciona las configuraciones en que la propiedad EnableArchiving es igual a (-eq) "ImAndWebConf". A continuación, la recopilación filtrada se transfiere a Set-CsArchivingConfiguration, que cambia el valor de la propiedad EnableArchiving de todos los elementos de la recopilación a "ImOnly".