Partager via

  • Article

Set-CsArchivingConfiguration

 

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

Modifie une collection existante de paramètres d’archivage de la messagerie instantanée.

Syntaxe

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

Description détaillée

De nombreuses organisations préfèrent conserver une transcription de toutes les sessions de messagerie instantanée et des conférences auxquelles leurs utilisateurs participent. D’autres organisations requièrent de conserver ces transcriptions ; par exemple, de nombreuses organisations dans le monde financier sont légalement tenues de garder des copies de toutes leurs communications électroniques.

Afin d’archiver les messages instantanés, vous devez configurer au moins un serveur d’archivage. Une fois le serveur d’archivage configuré, vous devez effectuer deux étapes supplémentaires. Tout d’abord, vous devez activer l’archivage au niveau de l’étendue globale (pour plus de détails, voir la rubrique Set-CsArchivingConfiguration). Si vous le souhaitez, vous pouvez également configurer des paramètres d’archivage personnalisés pour différents sites.

Ensuite, vous devez utiliser des stratégies d’archivage pour indiquer quels utilisateurs sont concernés par l’archivage de leurs sessions de messagerie instantanée. Les sessions de messagerie instantanée ne seront pas archivées à moins qu’une stratégie en vigueur nécessite l’archivage des sessions de messagerie instantanée.

Quand vous installez Lync Server 2010, une collection de paramètres de configuration 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. Dans tous les cas, vous pouvez utiliser la cmdlet Set-CsArchivingConfiguration pour modifier les valeurs de propriété d’une collection existante ou les paramètres de configuration de l’archivage.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsArchivingConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Correspond à l’identificateur unique de la collection de paramètres de configuration d’archivage à modifier. Pour modifier les paramètres globaux, ignorez ce paramètre ou bien utilisez la syntaxe suivante : -Identity global. Pour modifier les paramètres au niveau de l’étendue Site, utilisez le préfixe « site: » suivi du nom de site. Par exemple : -Identity "site:Redmond".

Instance

Facultatif

Objet ArchivingSettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

ArchiveDuplicateMessages

Facultatif

Booléen

Indique comment les messages instantanés inter-pools doivent être archivés. Prenons cet exemple simple : Ken Myer (dont le compte est dans le Pool 1) envoie un message instantané à Pilar Ackerman (dont le compte figure dans le Pool 2). À son tour, Pilar répond 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 (valeur par défaut), la transcription sera journalisée dans les deux pools.

BlockOnArchiveFailure

Facultatif

Booléen

Si la valeur est définie sur True, le service de messagerie instantanée sera interrompu chaque fois que les messages instantanés ne peuvent pas être archivés. Si la valeur est définie sur False (valeur par défaut), la messagerie instantanée fonctionne même si les messages instantanés ne peuvent pas être archivés.

CachePurgingInterval

Facultatif

Entier

Indique la fréquence (en heures) à laquelle les transcriptions seront supprimées du système quand l’archivage n’est activé pour aucun des participants. De par leur conception, les sessions de messagerie instantanée de groupes et de conférence sont enregistrées pendant qu’elles ont lieu. Pendant ce laps de temps défini, le système détermine si l’archivage a été activé pour certains des participants à ces sessions. Si le système trouve une session dans laquelle aucun des participants ne bénéficient de la fonction d’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

Si la valeur est définie sur True, les messages instantanés archivés sont régulièrement supprimés de la base de données à condition que ces messages instantanés : 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.

Si la valeur est définie sur False, les messages instantanés ne seront pas supprimés automatiquement de la base de données.

KeepArchivingDataForDays

Facultatif

Entier

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 n’ont pas été exportés restent dans la base de données, même si ces messages instantanés sont antérieurs à la valeur indiqué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 planifier la purge à 4:00 AM, mais non à 4:30AM ou 4:15 AM. La valeur par défaut est 2 (2:00 AM).

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.

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

Objet Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings. Set-CsArchivingConfiguration accepte la saisie de données transmises via le pipeline pour l’objet de configuration de l’archivage.

Types de retours

Set-CsArchivingConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Exemple

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

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

Dans l’exemple ci-dessus, la cmdlet Set-CsArchivingConfiguration est utilisée pour modifier deux propriétés des paramètres de configuration de l’archivage dont le paramètre Identity est site:Redmond. Cette commande définit d’abord la propriété ArchiveDuplicateMessages sur False. Cela empêche le serveur d’archiver la même session de messagerie instantanée plusieurs fois. Cette commande utilise également le paramètre KeepArchivingDataForDays pour demander au serveur de conserver les messages instantanés pendant 30 jours.

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

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

L’exemple 2 est une variante de la commande de l’exemple 1 : cependant, dans ce cas, les valeurs des propriétés ArchiveDuplicateMessages et KeepArchivingDataForDays sont modifiées pour tous les paramètres d’archivage qui ont été configurés au niveau de l’étendue Site. Pour réaliser cette tâche, la commande utilise d’abord la cmdlet Get-CsArchivingConfiguration et le paramètre Filter pour retourner une collection de tous les paramètres d’archivage configurés au niveau de l’étendue Site ; la valeur de filtre « site:* » garantit que seuls les paramètres dont l’identité commence par les caractères « site: » sont retournés. La collection filtrée est ensuite redirigée vers la cmdlet Set-CsArchivingConfiguration qui modifie les deux valeurs de propriété pour chaque élément contenu dans la collection.

-------------------------- Exemple 3 --------------------------

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

Dans l’exemple 3, tous les paramètres de configuration de l’archivage permettant l’archivage des sessions de messagerie instantanée et des conférences Web sont modifiés. À la fin de la commande, ces paramètres n’autoriseront que l’archivage des sessions de messagerie instantanée. Pour cela, la commande appelle d’abord Get-CsArchivingConfiguration sans paramètre afin de retourner une collection de tous les paramètres de configuration de l’archivage utilisés dans l’organisation. Cette collection est alors redirigée vers la cmdlet Where-Object. Celle-ci sélectionne uniquement les paramètres dont la propriété EnableArchiving est égale à (-eq) « ImAndWebConf ». La collection filtrée est ensuite redirigée vers la cmdlet Set-CsArchivingConfiguration qui extrait chaque élément de la collection et définit la valeur de la propriété EnableArchiving sur ImOnly.