New-CsDiagnosticsFilter
Dernière rubrique modifiée : 2012-03-23
Crée un nouveau filtre de diagnostic à utiliser avec les paramètres de configuration de diagnostic. 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
New-CsDiagnosticsFilter [-Enabled <$true | $false>] [-ExcludeConferenceMessages <$true | $false>] [-ExcludePresenceNotifications <$true | $false>] [-ExcludeRegisterMessages <$true | $false>] [-ExcludeSubscribeMessages <$true | $false>] [-Fqdn <PSListModifier>] [-Uri <PSListModifier>]
Description détaillée
Si vous activez la journalisation 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. Ceci permet d’enregistrer un maximum d’informations dans les fichiers journaux.
En revanche, cela peut également générer un surplus d’informations. 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. Par exemple, vous pouvez choisir de consigner uniquement le trafic en provenance ou à destination de domaines spécifiés. Outre les paramètres globaux, Lync Server vous permet de créer des paramètres de diagnostic au niveau de l’étendue Site ou de l’étendue Service (soit pour le serveur Edge, soit pour le service Serveur d’inscriptions). Ceci vous permet ensuite d’appliquer au site de Redmond des paramètres différents de ceux que vous appliquez à vos autres sites.
La cmdlet New-CsDiagnosticsFilter vous permet d’ajouter un filtre à une collection de paramètres de diagnostic. Cette collection contient les domaines et les URI dont le trafic sera enregistré dans les fichiers journaux. Lorsque vous ajoutez un filtre, seules les informations appartenant aux domaines et aux URI du filtre seront enregistrées. Le trafic provenant d’autres domaines et URI ne sera pas enregistré.
Notez que la cmdlet New-CsDiagnosticsFilter crée des instances en mémoire uniquement d’un filtre de diagnostic. Après avoir créé l’un de ces filtres virtuels, vous devez alors utiliser soit la cmdlet New-CsDiagnosticConfiguration, soit la cmdlet Set-CsDiagnosticConfiguration pour ajouter le filtre à une collection.
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-CsDiagnosticsFilter : 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-CsDiagnosticsFilter"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Enabled |
Obligatoire |
Booléen |
Indique si le filtre doit être employé ou non. La valeur par défaut est True ($True). |
ExcludeConferenceMessages |
Facultatif |
Booléen |
Si ce paramètre est défini sur True, les informations sur les messages de conférence (soit tous les messages contenant un URI de conférence dans l’en-tête À ou De)ne seront pas enregistrées dans les fichiers journaux. La valeur par défaut est False. |
ExcludePresenceNotifications |
Facultatif |
Booléen |
Si ce paramètre est défini sur True, les informations sur les notifications de présence (soit tous les messages utilisant la méthode NOTIFY ou BENOTIFY) ne seront pas enregistrées dans les fichiers journaux. La valeur par défaut est False. |
ExcludeRegisterMessages |
Facultatif |
Booléen |
Si ce paramètre est défini sur True, les informations sur les inscriptions des clients (soit tous les messages utilisant la méthode REGISTER) ne seront pas enregistrées dans les fichiers journaux. La valeur par défaut est False. |
ExcludeSubscribeMessages |
Facultatif |
Booléen |
Si ce paramètre est défini sur True, les informations sur les inscriptions des clients (soit tous les messages utilisant la méthode SUBSCRIBE) ne seront pas enregistrées dans les fichiers journaux. La valeur par défaut est False. |
Fqdn |
Facultatif |
Modificateur de liste PS |
Collection de domaines à inclure dans le filtre. (Techniquement, ces domaines représentent la partie hôte d’une adresse SIP.) Pour la propriété FQDN, vous pouvez utiliser un nom de domaine complet semblable à celui-ci : fabrikam.com. Vous pouvez également utiliser des caractères génériques pour représenter plusieurs domaines : *.fabrikam.com. Il est possible d’intégrer plusieurs domaines dans un seul filtre. |
Uri |
Facultatif |
Modificateur de liste PS |
Collection des URI à inclure dans le filtre. (L’URI correspond à la partie utilisateur@hôte d’une adresse SIP.) Un URI comprend l’un des modèles suivants user@fabrikam.com user@* *@fabrikam.com Vous pouvez inclure plusieurs URI dans un seul filtre. |
Types d’entrées
Aucun. New-CsDiagnosticsFilter n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsDiagnosticsFilter crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter.
Exemple
-------------------------- Exemple 1 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Les commandes présentées dans l’exemple 1 utilisent la cmdlet New-CsDiagnosticsFilter pour créer un nouveau filtre de diagnostic, puis affecter ce filtre aux paramètres de configuration de diagnostic globaux. Pour réaliser cette tâche, la première commande appelle New-CsDiagnosticsFilter pour créer un filtre de diagnostic en mémoire uniquement. Ce filtre ajoute le nom de domaine complet (FQDN) fabrikam.com et l’URI user@fabrikam.com au filtre. La commande définit également la propriété Enabled en lui attribuant la valeur True ($True) afin d’activer le filtre. Le filtre virtuel qui en résulte est alors stocké dans la variable $x.
Dans la deuxième commande, la cmdlet Set-CsDiagnosticConfiguration est utilisée pour affecter le nouveau filtre aux paramètres de configuration de diagnostic globaux. Dans ce cas, toutes les valeurs existantes dans la propriété Filter seront remplacées par le filtre à peine créé et stocké dans la variable $x.
-------------------------- Exemple 2 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com","contoso.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Les commandes présentées dans l’exemple 2 sont une variante des commandes illustrées dans les exemples 1 et 2. Cependant, deux noms de domaine complets (fabrikam.com et contoso.com) sont ajoutés à la propriété Fqdn du filtre. Pour cela, les deux noms (séparés par une virgule) sont utilisés en guise de valeurs de paramètres pour le paramètre Fqdn.