Remove-CsCdrConfiguration
Dernière rubrique modifiée : 2012-03-26
Supprime la collection spécifiée de paramètres d’enregistrement des détails concernant les 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
Remove-CsCdrConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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. CDR (qui n’est disponible que si vous avez déployé le service d’analyse) garde en mémoire les informations d’utilisation. Il consigne des informations telles que les parties impliquées dans l’appel ; la durée de l’appel ; le transfert éventuel de fichiers. (Toutefois, l’enregistrement des détails des appels n’enregistre pas l’appel lui-même.)
CDR garde également en mémoire les informations sur les erreurs relatives aux 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écider si l’enregistrement des détails des appels est utilisé dans votre organisation. En effet, si vous avez déployé le service de surveillance, vous pouvez aisément activer/désactiver l’enregistrement des détails des appels. De plus, vous avez la possibilité de prendre une décision globalement (auquel cas l’enregistrement des détails des appels pourra soit être activé ou désactivé dans toute l’organisation) ou par site. Par exemple, vous pouvez utiliser l’enregistrement des détails des appels sur le site de Redmond, mais pas sur le site de Paris.
Les paramètres spécifiques au site que vous créez à l’aide de New-CsCdrConfiguration peuvent par la suite être supprimés à l’aide de la cmdlet Remove-CsCdrConfiguration. Quand vous supprimez des paramètres spécifiques au site, l’enregistrement des détails des appels pour le site affecté sera automatiquement régi par les paramètres globaux de configuration de l’enregistrement des détails des appels.
Vous pouvez également exécuter Remove-CsCdrConfiguration sur les paramètres globaux d’enregistrement des détails des appels. Toutefois, du fait que les paramètres globaux ne peuvent pas être supprimés, ils seront simplement réinitialisés à leurs valeurs par défaut. Par exemple, supposons que vous définissez la valeur de la propriété KeepCallDetailForDays dans les paramètres globaux sur 90. Si vous exécutez Remove-CsCdrConfiguration sur les paramètres globaux, cette propriété sera réinitialisée à sa valeur par défaut, qui est de 60.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsCdrConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique des paramètres de configuration d’enregistrement des détails des appels à supprimer. Pour « supprimer » les paramètres globaux, utilisez cette syntaxe : -Identity global. (Il est encore à noter que vous ne pouvez pas supprimer véritablement les paramètres globaux ; au lieu de cela, vous réinitialisez les propriétés à leurs valeurs par défaut.) Pour supprimer les paramètres configurés au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Vous ne pouvez pas utiliser de caractères génériques pour spécifier une identité. |
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. Remove-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
Aucun. Au lieu de cela, la cmdlet supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsCdrConfiguration -Identity site:Redmond
La commande ci-dessus utilise Remove-CsCdrConfiguration pour supprimer les paramètres d’enregistrement des détails des appels affectés au site de Redmond. Utiliser le paramètre Identity garantit que seuls les paramètres affectés à un site spécifié seront supprimés.
-------------------------- Exemple 2 --------------------------
Get-CsCdrConfiguration -Filter site:* | Remove-CsCdrConfiguration
La commande illustrée dans l’exemple 2 supprime tous les paramètres d’enregistrement des détails affectés au niveau de l’étendue Site. Pour ce faire, la commande utilise d’abord Get-CsCdrConfiguration et le paramètre Filter pour récupérer les paramètres d’enregistrement des détails des appels adéquats. La valeur de chaîne « site:* » garantit que seuls les paramètres ayant une identité qui commence par les caractères « site: » sont retournés. La collection filtrée est ensuite redirigée vers Remove-CsCdrConfiguration qui supprime tous les éléments dans la collection.
-------------------------- Exemple 3 --------------------------
Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30} | Remove-CsCdrConfiguration
Dans l’exemple 3, tout paramètre d’enregistrement des détails des appels pour lequel la propriété KeepCallDetailForDays est inférieure à 30 jours est supprimé. Pour effectuer cette tâche, la commande appelle d’abord Get-CsCdrConfiguration sans paramètre afin de retourner une collection de tous les paramètres d’enregistrement des détails des appels utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne sélectionne que les paramètres pour lesquels la propriété KeepCallDetailForDays est inférieure à 30 jours. La collection filtrée est alors redirigée vers Remove-CsCdrConfiguration qui supprime chaque élément contenu dans la collection.