Partager via

  • Article

New-CsArchivingConfiguration

 

Dernière rubrique modifiée : 2012-03-23

Crée un nouveau jeu de paramètres d’archivage pour la messagerie instantanée. Ces paramètres peuvent être utilisés pour activer ou désactiver l’enregistrement automatique des sessions de messagerie instantanée. Ils vous permettent de bloquer les messages instantanés non archivables.

Syntaxe

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>]]

Description détaillée

Bon nombre d’organisations considèrent utile de conserver une transcription de toutes les sessions de messagerie instantanée auxquelles leurs utilisateurs ont pris part. D’autres considèrent que les conserver est obligatoire. Par exemple, nombre d’organisations dans le domaine financier sont tenus par la loi de conserver des copies de toutes les communications électroniques.

Microsoft Lync Server 2010 vous offre cette flexibilité lorsqu’il s’agit d’archiver des sessions de conférences Web et de messagerie instantanée. Si vous avez déployé serveur d’archivage, vous pouvez utiliser les diverses cmdlets CsArchivingConfiguration pour activer et désactiver l’archivage des sessions de messagerie instantanée et gérer votre base de données d’archivage. Vous pouvez également suspendre la messagerie instantanée en cas d’échec de l’archivage ; cela permet de garantir la tenue d’un registre de toutes vos communications électroniques.

Quand vous installez Lync Server 2010, une collection de paramètres d’archivage globaux est créée automatiquement. Par défaut, ces paramètres s’appliquent à toute l’organisation. Sinon, vous pouvez utiliser la cmdlet New-CsArchivingConfiguration pour créer des paramètres de configuration personnalisés site par site.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsArchivingConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique à affecter à la nouvelle collection de paramètres de configuration de l’archivage. Puisque vous ne pouvez créer des collections qu’au niveau de l’étendue Site, l’identité sera toujours le préfixe « site: » suivi du nom du site, par exemple « site:Redmond ».

ArchiveDuplicateMessages

Facultatif

Booléen

Spécifie la manière dont les messages instantanés de pool croisés doivent être archivés. Par exemple, Ken Myer (avec un compte dans le pool 1) envoie un message instantané à Pilar Ackerman (qui a un compte dans le pool 2). À son tour, Pilar envoie une réponse au message instantané de Ken. Si ArchiveDuplicateMessages a la valeur False, alors (sur la base de l’algorithme intégré), la transcription de session sera journalisée soit dans le pool 1 ou le pool 2, mais pas les deux. Si ArchiveDuplicateMessages a la valeur True (la valeur par défaut), la transcription sera journalisée dans les deux pools.

BlockOnArchiveFailure

Facultatif

Booléen

S’il est configuré avec la valeur True, le service de messagerie instantanée sera suspendu chaque fois que les sessions de messagerie instantanée ne pourront être archivées. S’il est configuré avec la valeur False (valeur par défaut), la session de messagerie instantanée se poursuivra même si elle ne peut pas être archivée.

CachePurgingInterval

Facultatif

Entier

Indique la fréquence (en heures) à laquelle le système est purgé des transcriptions quand aucun des participants n’a été activé pour archivage. De par leur conception, les sessions de messagerie instantanée de groupes et de conférence sont enregistrées pendant qu’elles ont lieu. Le système déterminera si certains participants à ces sessions ont été activés pour archivage pendant l’intervalle spécifié. Si le système trouve une session pour laquelle les participants ont été activés pour archivage, alors la transcription sera supprimée de la base de données.

La propriété CachePurgeInterval peut être définie avec n’importe quelle valeur entière comprise entre 4 et 168 (inclus). La valeur par défaut est 24.

EnableArchiving

Facultatif

Chaîne

Indique quels éléments (le cas échéant) sont sauvegardés dans la base de données d’archivage. Les valeurs valides sont les suivantes :

None. Aucun élément n’est archivé dans la base de données. Il s’agit de la valeur par défaut.

ImOnly. Les sessions de messagerie instantanée sont archivées dans la base de données.

ImAndWebConf. Les sessions de messagerie instantanée et les conférences Web sont archivées dans la base de données.

EnablePurging

Facultatif

Booléen

S’il est configuré avec la valeur True, les messages instantanés archivés sont supprimés périodiquement de la base de données, à condition que ces messages : 1) soient plus anciens que la valeur spécifiée dans la propriété KeepArchivingDataForDays, ou, 2) aient été exportés et signalés pour suppression.

S’il est configuré avec la valeur False, les messages instantanés ne seront pas automatiquement supprimés de la base de données.

KeepArchivingDataForDays

Facultatif

Entier

Le nombre de jours (entre 1 et 2562) pendant lesquels les messages instantanés sont archivés dans la base de données avant d’être automatiquement supprimés. La valeur par défaut est 14.

Cette propriété prend effet uniquement si la valeur EnablePurging a été configurée sur True.

PurgeExportedArchivesOnly

Facultatif

Booléen

Si la valeur est True, alors le système ne purgera que les messages instantanés qui ont été exportés (et, qui de ce fait ont été repérés pour suppression). Les messages instantanés qui ont été exportés resteront dans la base de données, même si ces messages sont plus anciens que la valeur spécifiée par la propriété KeepArchivingDataForDays.

PurgeHourOfDay

Facultatif

Entier

Indique l’heure de la journée à laquelle les enregistrements expirés sont supprimés de la base de données d’archivage. L’heure de la journée est spécifiée à l’aide de l’horloge 24 heures, avec 0 qui représente minuit (24 h) et 23 qui représente 23 h. Notez que vous ne pouvez spécifier que l’heure de la journée. Cela signifie que vous pouvez programmer la purge à 4 h, mais que vous ne pouvez pas la programmer à 4 h 30 ou 4 h 15 par exemple. La valeur par défaut est 2 h.

La purge de la base de données a lieu uniquement si la propriété EnablePurging a la valeur True.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Aucun. New-CsArchivingConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsArchivingConfiguration crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Exemple

-------------------------- Exemple 1 --------------------------

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

La commande indiquée à l’exemple 1 crée une nouvelle collection de paramètres de configuration de l’archivage et applique ces paramètres au site Redmond. En ajoutant le paramètre EnableArchiving et en donnant la valeur « ImOnly » à ce paramètre , la commande active également l’archivage de la session de messagerie instantanée (mais pas l’archivage de la conférence Web) pour le site de Redmond.

-------------------------- Exemple 2 --------------------------

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

L’exemple précédent montre comment utiliser le paramètre InMemory pour créer une collection de paramètres de configuration d’archivage qui n’existait initialement qu’en mémoire. Pour ce faire, l’exemple crée une collection de paramètres (avec l’identité site:Redmond) et enregistre cette collection dans une variable appelée $x. Notez qu’une fois cette première commande exécutée, la collection n’existera qu’en mémoire. Si vous exécutez la commande Get-CsArchivingConfiguration, vous ne pourrez voir aucune entrée pour site:Redmond.

Dans la deuxième commande, la propriété EnableArchiving pour cette collection virtuelle de paramètres a la valeur « ImOnly » qui permet d’activer l’archivage de la session de messagerie instantanée. Enfin, la dernière commande utilise Set-CsArchivingConfiguration pour transformer les paramètres d’archivage virtuels en collection effective de paramètres appliqués au site Redmond. Si vous n’appelez pas Set-CsArchivingConfiguration, ces paramètres resteront en mémoire uniquement et disparaîtront une fois que la session Windows PowerShell sera terminée ou que la variable $x sera supprimée.