Partager via

  • Article

Get-CsDiagnosticConfiguration

 

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

Retourne des informations sur les paramètres de configuration de diagnostic actuellement utilisés 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

Get-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDiagnosticConfiguration [-Filter <String>] [-LocalStore <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.

La cmdlet Get-CsDiagnosticConfiguration permet de retourner des informations sur les paramètres de configuration de diagnostic actuellement utilisés dans l’organisation.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsDiagnosticConfiguration : RTCUniversalUserAdmins, 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 "Get-CsDiagnosticConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres de configuration de diagnostic à retourner. Pour retourner les paramètres configurés dans l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Pour retourner les paramètres globaux, utilisez la syntaxe suivante : -Identity global.

Si vous ne définissez pas ce paramètre, tous les paramètres de configuration de diagnostic actuellement utilisés sont retournés.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques lorsque vous indiquez la ou les collections de paramètres à retourner. Par exemple, cette syntaxe retourne tous les paramètres configurés au niveau de l'étendue Site : -Filter "site:*".

Notez que vous ne pouvez pas utiliser les paramètres Filter et Identity dans la même commande.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les données de configuration de diagnostic à partir du réplica local du magasin central de gestion et non depuis le magasin central de gestion lui-même.

Types d’entrées

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

Types de retours

Get-CsDiagnosticConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Exemple

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

Get-CsDiagnosticConfiguration

L’exemple 1 retourne des informations pour tous les paramètres de configuration de diagnostic actuellement utilisés dans l’organisation. Cette opération est effectuée en appelant la cmdlet Get-CsDiagnosticConfiguration sans aucun paramètre.

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

Get-CsDiagnosticConfiguration -Identity site:Redmond

La commande ci-dessus retourne des informations sur les paramètres de configuration de diagnostic appliqués au site de Redmond (-Identity site:Redmond).

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

Get-CsDiagnosticConfiguration -Identity site:Redmond | Select-Object -ExpandProperty Filter

La commande présentée dans l’exemple 3 affiche des informations sur chacun des filtres figurant dans les paramètres de configuration de diagnostic du site de Redmond. Pour ce faire, la commande utilise d’abord Get-CsDiagnosticConfiguration pour retourner les paramètres du site de Redmond. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour « développer » la valeur de la propriété Filter. En développant la propriété Filter, vous pouvez accéder aux propriétés et aux valeurs des propriétés de chacun des filtres gérés dans les paramètres de configuration de diagnostic.

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

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -contains "sip:diagnostics@litwareinc.com"}

La commande présentée dans l’exemple 4 retourne un sous-ensemble des filtres figurant dans les paramètres de configuration de diagnostic globaux, notamment les filtres dont la propriété Uri contient l’adresse SIP sip:diagnostics@litwareinc.com. Pour ce faire, la commande utilise d’abord Get-CsDiagnosticConfiguration pour retourner toutes les informations de filtre de l’instance globale des paramètres de configuration de diagnostic. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui développe la propriété Filter. Les objets de filtre individuels sont ensuite redirigés vers Select-Object qui extrait uniquement les filtres dont la propriété Uri contient l’adresse SIP sip:diagnostics@litwareinc.com.

-------------------------- Exemple 5 ------------------------

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -notcontains "sip:diagnostics@litwareinc.com"}

L’exemple 5 est une variante de la commande présentée dans l’exemple 4. Cependant, dans ce cinquième exemple, les filtres sont retournés uniquement si la propriété Uri ne contient pas l’adresse SIP sip:diagnostics@litwareinc.com. Pour réaliser cette tâche, la commande appelle la cmdlet Get-CsDiagnosticConfiguration pour retourner toutes les informations de configuration de diagnostic de l’instance globale des paramètres de configuration. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui développe la propriété Filter. Les objets de filtre sont enfin redirigés vers la cmdlet Select-Object qui extrait uniquement les filtres dont la propriété Uri ne contient pas l’adresse SIP sip:diagnostics@litwareinc.com.