Partager via

  • Article

Remove-CsDiagnosticConfiguration

 

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

Supprime une ou plusieurs collections de paramètres de configuration de diagnostic actuellement utilisées dans votre organisation. Les paramètres de configuration de diagnostic sont utilisés pour déterminer si le trafic en provenance ou à destination d’un domaine donné ou d’un URI (Uniform Resource Identifier) est enregistré dans vos fichiers journaux Microsoft Lync Server 2010.

Syntaxe

Remove-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Si vous activez la connexion pour Lync Server 2010, alors par défaut, le trafic à destination ou en provenance de tout domaine ou URI sera inclus dans ces fichiers journaux. Cela permet qu’un maximum d’informations soit enregistré dans les fichiers journaux.

Toutefois, une trop grande quantité d’informations peut être générée. Par exemple, si vous rencontrez des problèmes de connectivité avec un domaine particulier, vous souhaiterez peut-être limiter la journalisation du trafic entre votre réseau et ce domaine en particulier : il sera ainsi plus facile pour vous d’identifier les enregistrements pertinents et ainsi, de faciliter le diagnostic et la résolution du problème.

Les paramètres de configuration de diagnostic vous permettent d’indiquer les domaines ou URI qui seront enregistrés dans les fichiers journaux ; si un filtre de diagnostic est activé, seul le trafic en provenance et à destination des domaines spécifiés sera enregistré. Lync Server vous permet de créer des paramètres de configuration de diagnostic et d’appliquer les filtres de diagnostic au niveau de l’étendue du site. Cela vous permet alors d’appliquer un filtre au site Redmond (par exemple) tout en désactivant le filtrage des autres sites.

Vous pouvez utiliser la cmdlet Remove-CsDiagnosticConfiguration pour supprimer les paramètres de configuration de diagnostic que vous avez créés au niveau de l’étendue du site. La cmdlet Remove-CsDiagnosticConfiguration peut aussi être exécutée avec les paramètres globaux de configuration de diagnostic. Cependant, dans ce cas, la collection n’est pas supprimée ; en effet, Lync Server ne vous autorise pas à supprimer des collections globales. Au contraire, la suppression d’une collection globale entraîne la réinitialisation des propriétés de cette collection. Par conséquent, tous les filtres ajoutés à cette collection seront supprimés.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique des paramètres de configuration de diagnostic à supprimer. Pour supprimer les paramètres configurés au niveau de l’étendue Site, utilisez une syntaxe du type : -Identity "site:Redmond".

Remove-CsDiagnosticConfiguration peut également être exécutée avec les paramètres de configuration globaux ; dans ce cas, utilisez la syntaxe : –Identity global. Cependant, les paramètres globaux ne seront pas supprimés ; au lieu de cela, les propriétés identifiées dans les paramètres globaux seront réinitialisées d’après leurs valeurs par défaut.

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.Diagnostics.DiagnosticFilterSettings. Remove-CsDiagnosticConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres de filtre de diagnostic.

Types de retours

Aucun. Au lieu de cela,Remove-CsDiagnosticConfiguration supprime les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Exemple

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

Remove-CsDiagnosticConfiguration -Identity site:Redmond

La commande ci-dessus supprime les paramètres de configuration de diagnostic dont la valeur Identity (identité) est site:Redmond.

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

Get-CsDiagnosticConfiguration -Filter site:* | Remove-CsDiagnosticConfiguration

La commande illustrée dans l’exemple 2 supprime tous les paramètres de configuration de diagnostic qui ont été configurés au niveau de l’étendue du site. Pour ce faire, la commande appelle Get-CsDiagnosticConfiguration ainsi que le paramètre Filter ; La valeur de filtre « site:* » restreint les données renvoyées aux paramètres dont l’identité commence par les caractères « site: ». La collection filtrée est ensuite redirigée vers Remove-CsDiagnosticConfiguration, qui supprime chaque élément de cette collection.

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

Get-CsDiagnosticConfiguration | Remove-CsDiagnosticConfiguration

La commande illustrée dans l’exemple 3 supprime tous les paramètres de configuration de diagnostic actuellement utilisés dans l’organisation. Pour effectuer cette tâche, Get-CsDiagnosticConfiguration est d’abord appelée sans paramètre afin de retourner une collection de tous les paramètres de configuration de diagnostic actuellement utilisés dans l’organisation. Ces éléments sont ensuite redirigés vers Remove-CsDiagnosticConfiguration qui supprime chaque élément de la collection.