Partager via

  • Article

Set-CsDiagnosticConfiguration

 

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

Modifie les paramètres de configuration de diagnostic existants. 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

Set-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsDiagnosticConfiguration [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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. Ceci permet d’enregistrer un maximum d’informations dans les fichiers journaux.

Toutefois, ceci peut parfois 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 de spécifier les domaines ou les URI qui seront enregistrés dans les fichiers journaux. Avec Lync Server, vous pouvez élaborer des paramètres de configuration de diagnostic au niveau de l’étendue Site. Ceci vous permet ensuite d’appliquer au site de Redmond des paramètres différents de ceux que vous appliquez sur vos autres sites.

Vous pouvez également utiliser la cmdlet Set-CsDiagnosticConfiguration pour ajouter ou supprimer des filtres dans une collection donnée. Les filtres sont utilisés pour indiquer aux domaines quel trafic journaliser.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres de configuration de diagnostic à modifier. Pour modifier des paramètres au niveau du site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Pour modifier les paramètres globaux, utilisez la syntaxe : -Identity global.

Si ce paramètre n’est pas spécifié, alors Set-CsDiagnosticConfiguration modifiera automatiquement les paramètres globaux.

Instance

Facultatif

Objet DiagnosticFilterSettings

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

Filter

Facultatif

Modificateur de liste PS

Collection de domaines et d’URI dont le trafic sera journalisé. La propriété Filter comporte trois éléments séparés et doit être créée à l'aide de la cmdlet New-CsDiagnosticsFilter :

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 complet de domaine (FQDN) peut ressembler à ceci : fabrikam.com. Vous pouvez également utiliser des caractères génériques pour représenter plusieurs domaines : *.fabrikam.com. Vous pouvez inclure plus d’un domaine dans un seul filtre.

URI – Collection d’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  utilisateur@fabrikam.com ; utilisateur@*; *@fabrikam.com. Vous pouvez inclure plusieurs URI dans un seul filtre.

Enabled – Indique si le filtre doit être utilisé ou pas.

LoggingShare

Facultatif

Chaîne

Dossier partagé dans lequel les journaux de diagnostic peuvent être téléchargés.

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

Types de retours

Set-CsDiagnosticConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Exemple

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri sip:user@fabrikam.com 
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Les commandes présentées dans l’exemple 1 utilisent la cmdlet New-CsDiagnosticsFilter pour créer un filtre de diagnostic, puis affectent ce filtre aux paramètres de configuration de diagnostic globaux. Pour effectuer cette tâche, la première commande appelle New-CsDiagnosticsFilter pour créer en mémoire uniquement un filtre de diagnostic qui utilise le nom de domaine complet (FQDN) fabrikam.com et l’URI sip:user@fabrikam.com. Le filtre « virtuel » qui en résulte est alors stocké dans la variable $x.

Dans la deuxième commande, la cmdlet Set-CsDiagnosticConfiguration affecte 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 nouvellement créé.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Add("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

L’exemple 2 montre comment vous pouvez ajouter un nouveau nom de domaine complet (FQDN) à la propriété Filter des paramètres de configuration de diagnostic globaux. Pour ce faire, la première commande dans l’exemple utilise Get-CsDiagnosticConfiguration pour récupérer la valeur de la propriété Filter des paramètres globaux. Il suffit pour cela de mettre l’appel à Get-CsDiagnosticConfiguration entre parenthèses, ce qui permet à Windows PowerShell d’exécuter la commande avant toute autre chose. Une fois les paramètres globaux renvoyés, la valeur de la propriété Filter est extraite et stockée dans une variable appelée $x.

Dans la deuxième commande, la méthode Add est utilisée pour ajouter un nouveau FQDN (fabrikam.com) au filtre. Lorsque c’est fait, la dernière commande de l’exemple utilise Set-CsDiagnosticConfiguration pour enregistrer la collection de diagnostics modifiée. Le résultat net est que fabrikam.com sera ajouté à tout FQDN déjà inclus dans la propriété Filter.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Remove("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Les commandes indiquées dans l’exemple 3 suppriment un FQDN (fabrikam.com) des paramètres de configuration de diagnostic globaux de la propriété Filter. La première commande de l’exemple utilise Get-CsDiagnosticConfiguration pour récupérer la valeur actuelle de la propriété Filter des paramètres globaux. Cette valeur est enregistrée dans une variable appelée $x. Une fois cette valeur récupérée, la méthode Remove est utilisée pour supprimer le FQDN fabrikam.com. Une fois le FQDN supprimé, Set-CsDiagnosticConfiguration est utilisée pour enregistrer le filtre modifié (stocké dans la variable $x) dans les paramètres globaux.

-------------------------- Exemple 4 ------------------------

Set-CsDiagnosticConfiguration -Identity global -Filter $Null

Dans l'exemple 4, tous les éléments sont supprimés de la propriété Filter des paramètres de configuration de diagnostic globaux. On effectue cette opération en donnant une valeur null à la propriété Filter.