Partager via


Set-CsCdrConfiguration

 

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

Modifie une collection existante de paramètres d’enregistrement des détails des appels. L’enregistrement des détails des appels permet d’assurer le suivi des sessions de messagerie instantanée d’égal à égal, des appels téléphoniques VoIP (Voice over Internet Protocol) et des téléconférences. Ces données d’utilisation permettent de savoir qui appelle qui, à quelle heure et la durée de l’entretien.

Syntaxe

Set-CsCdrConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Set-CsCdrConfiguration [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

L’enregistrement des détails des appels offre un moyen de suivre l’utilisation des fonctionnalités de Microsoft Lync Server 2010, comme les appels téléphoniques VoIP (Voice over Internet Protocol), la messagerie instantanée, les transferts de fichiers, les conférences audio/vidéo et les sessions de partage d’applications. L’enregistrement des détails des appels (qui n’est disponible que si vous avez déployé le service de surveillance) conserve les informations d’utilisation : il consigne des informations telles que les parties impliquées dans l’appel, la durée de l’appel et le transfert éventuel de fichiers. Toutefois, l’enregistrement des détails des appels n’enregistre pas l’appel proprement dit.

L’enregistrement des détails des appels garde également une trace des informations d’erreur des appels : données de diagnostic détaillées des sessions d’égal à égal et des téléconférences.

En tant qu’administrateur, vous pouvez déterminer si l’enregistrement des détails des appels est utilisé ou non dans votre organisation. En supposant que le service de surveillance a été déployé, vous pouvez activer ou désactiver l’enregistrement des détails des appels. Par ailleurs, vous pouvez prendre cette décision au niveau global (dans ce cas, l’enregistrement des détails des appels sera activé ou désactivé dans toute l’organisation) ou au niveau de sites individuels. Par exemple, vous pouvez utiliser l’enregistrement des détails des appels sur le site Redmond, mais pas sur le site Paris.

Les administrateurs peuvent également gérer la base de données d’enregistrement des détails des appels, par exemple, en spécifiant le nombre de jours durant lesquels les enregistrements sont conservés avant d’être purgés de la base de données. Ces modifications peuvent être effectuées à l’aide de la cmdlet Set-CsCdrConfiguration.

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-CsCdrConfiguration : 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-CsCdrConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique affecté à la collection des paramètres de configuration de l’enregistrement des détails des appels. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour vous référer à une collection configurée au niveau de l’étendue Site, utilisez une syntaxe de type : -Identity site:Redmond. Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité.

Si ce paramètre est omis, Set-CsCdrConfiguration modifie les paramètres globaux.

Instance

Facultatif

Objet CdrSettings

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

EnableCDR

Facultatif

Booléen

Indique si l’enregistrement des détails des appels est activé ou non. La valeur par défaut est True.

EnablePurging

Facultatif

Booléen

Indique si les enregistrements des détails des appels doivent être périodiquement supprimés de la base de données d’enregistrement des détails des appels. Si la valeur est définie sur True (valeur par défaut), les enregistrements sont supprimés après la période spécifiée par les propriétés KeepCallDetailForDays (enregistrements des détails des appels) et KeepErrorReportForDays (erreurs des détails des appels). Si la valeur est définie sur False, les enregistrements des détails des appels sont conservés indéfiniment.

KeepCallDetailForDays

Facultatif

Entier

Indique le nombre de jours durant lesquels les enregistrements des détails des appels sont conservés dans la base de données. Tout enregistrement plus ancien que le nombre de jours spécifié est automatiquement supprimé. (Notez que la purge ne se produit que si la propriété EnablePurging est définie sur True.)

Vous pouvez définir cette propriété sur n’importe quelle valeur d’entier comprise entre 1 et 2562 jours (environ 7 ans). La valeur par défaut est 60.

KeepErrorReportForDays

Facultatif

Entier

Indique le nombre de jours durant lesquels les rapports d’erreur sur l’enregistrement des détails des appels sont conservés. Tout rapport plus ancien que le nombre de jours spécifié est automatiquement supprimé. Les rapports d’erreur sur l’enregistrement des détails des appels sont des rapports de diagnostic téléchargés par des applications clientes comme Microsoft Lync 2010.

Vous pouvez définir cette propriété sur n’importe quelle valeur d’entier comprise entre 1 et 2562 jours (environ 7 ans). La valeur par défaut est 60.

PurgeHourOfDay

Facultatif

Entier

Indique l’heure locale du jour où les enregistrement qui ont expiré doivent être supprimés de la base de données d’enregistrements des détails des appels. L’heure est spécifiée au format 24 heures, 0 correspondant à minuit (00:00 AM) et 23 à 11:00 PM. Notez que vous ne pouvez indiquer que le chiffre des heures. Cela signifie que vous pouvez, par exemple, planifier la purge à 4:00 AM, mais pas à 4:30 AM ou 4:15 AM. La valeur par défaut est 2 (2:00 A.M.). Il est recommandé de planifier la purge en dehors des heures de travail.

La purge de la base de données ne se produit que si la propriété EnablePurging est définie sur 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

Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings. Set-CsCdrConfiguration accepte la saisie de données transmises via le pipeline des objets de configuration d’enregistrement des détails des appels.

Types de retours

Set-CsCdrConfiguration ne retourne aucune valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CDRSettings.

Exemple

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

Set-CsCdrConfiguration -Identity site:Redmond -PurgeHourOfDay 23 

L’exemple ci-dessus fixe l’heure de purge des enregistrements obsolètes. Dans le cas présent, l’heure de purge est définie sur 23 (ou 11:00 P.M.) avec le format 24 heures. Le paramètre Identity permet de vérifier que ces modifications ne sont effectuées que pour les paramètres d’enregistrement des détails des appels dont l’identité est site:Redmond.

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

Get-CsCdrConfiguration | Set-CsCdrConfiguration -PurgeHourOfDay 23 

L’exemple 2 est une variation de la commande illustrée dans l’exemple 1. Dans ce cas, la propriété PurgeHourOfDay est modifiée pour chaque collection de paramètres de configuration d’enregistrement des détails des appels utilisée dans l’organisation. Pour ce faire, la commande appelle d’abord Get-CsCdrConfiguration (sans paramètres) afin de retourner une collection de tous les paramètres d’enregistrement des détails des appels en cours d’utilisation. Cette collection est ensuite redirigée vers Set-CsCdrConfiguration, qui extrait chaque élément de la collection et attribue à la propriété PurgeHourOfDay la valeur 11:00 PM (23).

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

Get-CsCdrConfiguration -Filter "site:*"| Set-CsCdrConfiguration -PurgeHourOfDay 23

L’exemple 3 est une autre variation de la commande illustrée à l’exemple 1. Dans cet exemple, la propriété PurgeHourOfDay est modifiée pour tous les paramètres d’enregistrement des détails des appels ayant été configurés au niveau de l’étendue Site. Pour exécuter cette tâche, la commande appelle d’abord Get-CsCdrConfiguration avec le paramètre Filter ; la valeur de filtre "site:*" garantit que seuls les paramètres dont l’identité commence par la valeur de chaîne "site:*" sont retournés. La collection filtrée est alors redirigée vers Set-CsCdrConfiguration qui modifie la propriété PurgeHourOfDay pour chaque élément contenu dans la collection.