Partager via

  • Article

New-CsDiagnosticConfiguration

 

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

Crée des 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-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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. Ainsi, un maximum d’informations est enregistré dans les fichiers journaux.

Toutefois, cela peut aussi parfois produire une trop grande quantité 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 : 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 journaliser le trafic en provenance et à destination de domaines spécifiés uniquement. Lync Server vous permet de créer des paramètres de configuration de diagnostic au niveau de l’étendue Site. En retour, cela vous permet d’appliquer des paramètres, au site Redmond, par exemple, qui seront différents de ceux des autres sites.

Notez que vous ne pouvez pas créer de paramètres de configuration de diagnostic dans l’étendue globale. Cela est dû au fait que l’étendue globale héberge déjà ces paramètres. De la même manière, il est impossible de créer une collection de paramètres au niveau de l’étendue Site si le site en question contient déjà des paramètres de configuration de diagnostic. Par exemple, votre commande échouera si vous essayez de créer une nouvelle collection pour le site Redmond et que ce site héberge déjà des paramètres de configuration de diagnostic.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique des paramètres de configuration de diagnostic à créer. Puisque les nouveaux paramètres doivent impérativement être créés au niveau de l’étendue Site, vous devez utiliser une syntaxe de type : -Identity "site:Redmond".

Filter

Facultatif

Modificateur de liste PS

Collection de domaines et d’URI dont le trafic sera journalisé si le filtre de diagnostic est activé. La propriété Filter comporte trois éléments distincts :

FQDN : collection de domaines à inclure dans le filtre. (Techniquement, il s’agit de la partie hôte d’une adresse SIP.) Par exemple, un nom de domaine complet (FQDN) peut ressembler à : fabrikam.com. Vous pouvez également utiliser des caractères génériques pour représenter des domaines multiples : *.fabrikam.com. Vous pouvez inclure plusieurs domaines dans un seul filtre.

Uri : collection d’URI à inclure dans le filtre. (Il s’agit d’utilisateur@partie hôte d’une adresse SIP.) Un Uri se présente comme suit : user@fabrikam.com, user@* ou *@fabrikam.com. Vous pouvez inclure plusieurs URI dans un seul filtre.

Enabled : indique si le filtre doit être activé ou non.

LoggingShare

Facultatif

Chaîne

Dossier partagé dans lequel il est possible de télécharger les journaux de diagnostic.

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.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun. New-CsDiagnosticConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsDiagnosticConfiguration crée de nouvelles instances de Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Exemple

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

New-CsDiagnosticConfiguration -Identity site:Redmond

La commande précédente crée une collection de paramètres de configuration de diagnostic pour le site Redmond.

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri "sip:user@fabrikam.com" -Enabled $False 

New-CsDiagnosticConfiguration -Identity site:Redmond -Filter $x

Les commandes de l’exemple 2 créent un filtre de diagnostic pour ensuite l’affecter à une nouvelle collection de paramètres de diagnostic. Pour effectuer cette tâche, la première commande appelle New-CsDiagnosticsFilter pour créer en mémoire uniquement un filtre de diagnostic. Cette commande permet d’ajouter le nom de domaine complet (FQDN) fabrikam.com et l’URI sip:user@fabrikam.com au filtre. La commande configure é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 commande 2, la cmdlet New-CsDiagnosticConfiguration sert à créer une collection de paramètres de configuration de diagnostic pour le site Redmond. Ces nouveaux paramètres utilisent le filtre de diagnostic stocké dans la variable $x.

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

$x = New-CsDiagnosticConfiguration -Identity site:Redmond -InMemory
$x.LoggingShare = "\\atl-fs-001\logs"
Set-CsDiagnosticConfiguration -Instance $x

Les commandes illustrées à l’exemple 3 indiquent comment créer des paramètres de configuration de diagnostic n’existant qu’en mémoire initialement. Pour ce faire, la première commande appelle New-CsDiagnosticConfiguration ainsi que deux paramètres : Identity (qui spécifie l’identité des paramètres) et InMemory, qui indique que les nouveaux paramètres doivent être créés en mémoire uniquement. L’objet résultant est enregistré dans la variable $x.

Une fois que les paramètres virtuels ont été créés, la deuxième commande sert à configurer la propriété LoggingShare du chemin UNC \\atl-fs-001\logs. La commande finale est ensuite utilisée pour transformer les paramètres de configuration de diagnostic virtuels en collection de paramètres appliqués au site Redmond. Notez que cette commande finale est obligatoire. Si vous n’appelez pas Set-CsDiagnosticConfiguration, aucun paramètre ne sera appliqué au site Redmond et les paramètres virtuels disparaîtront dès que vous aurez terminé votre session Windows PowerShell ou supprimé la variable $x.