Partager via

Gestion de la configuration du service de journalisation centralisée de l’ordinateur, du site et du site dans Lync Server 2013

  • Article

 

Rubrique Dernière modification : 2014-02-04

Le service de journalisation centralisée peut être exécuté sur une étendue qui inclut un seul ordinateur, un pool d’ordinateurs, à une étendue de site (autrement dit, un site défini tel que le site Redmond qui contient une collection d’ordinateurs et de pools dans votre déploiement) ou à une étendue globale (autrement dit, tous les ordinateurs et pools de votre déploiement).

Pour configurer l’étendue du service de journalisation centralisée à l’aide de Lync Server Management Shell, vous devez être membre des groupes de sécurité CsAdministrator ou CsServerAdministrator, ou d’un rôle RBAC personnalisé qui contient l’un de ces deux groupes. Pour renvoyer la liste de tous les rôles RBAC auxquels cette applet de commande a été affectée (y compris les rôles RBAC personnalisés que vous avez créés vous-même), exécutez la commande suivante à partir de Lync Server Management Shell ou de l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Lync Server 2013 cmdlet>"}

Par exemple :

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}

Remarque

Windows PowerShell vous offre davantage d’options et d’options de configuration supplémentaires qui ne sont pas disponibles à l’aide de CLSController.exe. CLSController offre une méthode rapide et concise pour exécuter des commandes, mais elle est limitée à l’ensemble de commandes disponibles pour CLSController. Windows PowerShell ne se limite pas à la commande disponible pour le processeur de commandes du CLSController et fournit un ensemble plus large de commandes et un ensemble plus riche d’options. Par exemple, CLSController.exe vous fournit des options d’étendue pour les ordinateurs et les pools. Avec Windows PowerShell, vous pouvez indiquer des ordinateurs ou des pools dans la plupart des commandes, et quand vous définissez de nouveaux scénarios (CLSController a un nombre fini de scénarios qui ne sont pas modifiables par l’utilisateur), vous pouvez définir un site ou une étendue globale. Cette fonctionnalité puissante de Windows PowerShell vous permet de définir un scénario de site ou d’étendue globale, mais de limiter la journalisation réelle à un ordinateur ou à un pool.
Il existe des différences fondamentales entre les commandes de ligne de commande que vous pouvez exécuter dans Windows PowerShell ou CLSController. Windows PowerShell fournit une méthode enrichie pour configurer et définir des scénarios, et pour réutiliser ces scénarios de manière significative pour vos scénarios de dépannage. CLSController fournit un moyen rapide et efficace d’émettre des commandes et d’obtenir des résultats, l’ensemble de commandes pour CLSController est limité à un nombre fini de commandes disponibles à partir de la ligne de commande. Contrairement aux applets de commande Windows PowerShell, CLSController ne peut pas définir de nouveaux scénarios, gérer l’étendue au niveau du site ou global, et de nombreuses autres limitations d’un jeu de commandes fini qui ne peut pas être configuré dynamiquement. Bien que CLSController offre un moyen d’exécution rapide, Windows PowerShell fournit un moyen d’étendre la fonctionnalité du service de journalisation centralisée au-delà de ce qui est possible avec CLSController.

Une étendue d’ordinateur peut être définie lors de l’exécution d’une commande Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging et Update-CsClsLogging à lʼaide du paramètre –Computers. Ce paramètre accepte une liste des noms de domaine complet (FQDN) séparés par des virgules pour lʼordinateur cible.

Pointe

Vous pouvez également définir –Pools et une liste de pools séparée par des virgules sur laquelle exécuter les commandes de journalisation.

Les étendues de site et globales sont définies dans les applets de commande New-, Set-, and Remove- Centraled Logging Service. Les exemples suivants montrent comment définir une étendue globale ou de site.

Important

Les commandes indiquées peuvent contenir des paramètres et des concepts décrits dans d’autres sections. Les exemples de commandes sont conçus pour décrire l’utilisation du paramètre –Identity pour définir l’étendue, et les autres paramètres sont inclus pour être exhaustif et pour spécifier l’étendue. Pour plus d’informations sur les applets de commande Set-CsClsConfiguration, voir Set-CsClsConfiguration dans la documentation des opérations.

Pour récupérer la configuration actuelle du service de journalisation centralisée

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, cliquez sur Tous les programmes, sur Microsoft Lync Server 2013, puis sur Lync Server Management Shell.

  2. Tapez ce qui suit à l’invite de ligne de commande :

    Get-CsClsConfiguration

Utilisez les applets de commande New-CsClsConfiguration et Set-CsClsConfiguration pour créer une nouvelle configuration ou mettre à jour une configuration existante.

Lorsque vous exécutez lʼapplet Get-CsClsConfiguration, les informations affichées sont identiques à la capture dʼécran suivante, quand le déploiement utilise la configuration globale par défaut, sans configuration de site :

Exemple de sortie de Get-CsClsConfiguration.

Pour récupérer la configuration actuelle du service de journalisation centralisée à partir du magasin local de l’ordinateur

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, cliquez sur Tous les programmes, sur Microsoft Lync Server 2013, puis sur Lync Server Management Shell.

  2. Tapez ce qui suit à l’invite de ligne de commande :

    Get-CsClsConfiguration -LocalStore

Lorsque vous utilisez le premier exemple où Get-CsClsConfiguration ne spécifie aucun paramètre, la commande fait référence au magasin de gestion centrale pour les données. Si vous spécifiez le paramètre –LocalStore, la commande fait référence à l’ordinateur LocalStore au lieu du magasin central de gestion.

Pour récupérer une liste des scénarios actuellement définis

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, cliquez sur Tous les programmes, sur Microsoft Lync Server 2013, puis sur Lync Server Management Shell.

  2. Tapez ce qui suit à l’invite de ligne de commande :

    Get-CsClsConfiguration -Identity <scope and name> | Select-Object -ExpandProperty Scenarios

    Par exemple, pour récupérer les scénarios définis au niveau global :

    Get-CsClsConfiguration -Identity "global" | Select-Object -ExpandProperty Scenarios

Lʼapplet de commande Get-CsClsConfiguration affiche systématiquement les scénarios qui font partie de la configuration dʼune étendue donnée. Dans la plupart des cas, tous les scénarios ne sont pas affichés et sont tronqués. La commande utilisée ici répertorie tous les scénarios et des informations partielles concernant les fournisseurs, les paramètres et les indicateurs utilisés.

Pour mettre à jour une étendue globale pour le service de journalisation centralisée à l’aide de Windows PowerShell

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, cliquez sur Tous les programmes, sur Microsoft Lync Server 2013, puis sur Lync Server Management Shell.

  2. Tapez ce qui suit à l’invite de ligne de commande :

    Set-CsClsConfiguration -Identity <scope> -EtlFileRolloverSizeMB <size for logging file in megabytes>

    Exemple :

    Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40

La commande indique au CLSAgent de chaque ordinateur et pool du déploiement de définir la valeur de substitution dans le fichier de suivi à 40 mégaoctets. Les ordinateurs et les pools de tous les sites sont affectés par cette commande, et définiront la valeur de substitution du journal de suivi configuré à 40 mégaoctets.

Pour mettre à jour une étendue de site pour le service de journalisation centralisée à l’aide de Windows PowerShell

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, cliquez sur Tous les programmes, sur Microsoft Lync Server 2013, puis sur Lync Server Management Shell.

  2. Tapez ce qui suit à l’invite de ligne de commande :

    Set-CsClsConfiguration -Identity <scope/site name> -EtlFileRolloverSizeMB <size for logging file in megabytes> -EtlFileFolder <default location %TEMP%\Tracing>

    Exemple :

    Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40 -EtlFileFolder "C:\LogFiles\Tracing"

    Remarque

    Comme indiqué dans l’exemple, l’emplacement par défaut des fichiers journaux est %TEMP%\Tracing. Cependant, dans la mesure où CLSAgent écrit dans le fichier et qu’il s’exécute en tant que service réseau, la variable %TEMP% devient %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.

Cette commande indique au CLSAgent de chaque ordinateur et pool du site Redmond de définir la taille de la valeur de substitution du fichier de suivi à 40 mégaoctets. Les ordinateurs et les pools des autres sites ne sont pas affectés par cette commande, et continueront d’utiliser la valeur de substitution du journal de suivi configurée actuellement et définie par défaut (20 mégaoctets) ou lors du démarrage de la session de journalisation.

Pour créer une configuration de service de journalisation centralisée

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, cliquez sur Tous les programmes, sur Microsoft Lync Server 2013, puis sur Lync Server Management Shell.

  2. Tapez ce qui suit à l’invite de ligne de commande :

    New-CsClsConfiguration -Identity <scope and name> [CsClsConfiguration options for this site]

    Remarque

    New-CsClsConfiguration permet dʼaccéder à un grand nombre de paramètres de configuration facultatifs. Pour plus d’informations sur les options de configuration, consultez Get-CsClsConfiguration et Understanding Centraled Logging Service configuration settings in Lync Server 2013.

    Par exemple, pour créer une configuration qui définit un dossier réseau pour les fichiers en cache, la période de substitution pour les fichiers journaux et la taille de la substitution pour les fichiers journaux, tapez :

    New-CsClsConfiguration -Identity "site:Redmond" -CacheFileNetworkFolder "\\fs01.contoso.net\filestore\logfiles" -EtlFileRolloverMinutes 120 -EtlFileRolloverSizeMB 40

Vous devez planifier soigneusement la création de nouvelles configurations et la façon dont vous définissez de nouvelles propriétés pour le service de journalisation centralisée. Faites attention lorsque vous apportez des modifications et assurez-vous de bien comprendre l’impact sur la journalisation des scénarios. Apportez des modifications à la configuration pour améliorer la résolution des problèmes en permettant une meilleure gestion des tailles de journaux et de la période de substitution.

Pour supprimer une configuration de service de journalisation centralisée existante

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, cliquez sur Tous les programmes, sur Microsoft Lync Server 2013, puis sur Lync Server Management Shell.

  2. Tapez ce qui suit à l’invite de ligne de commande :

    Remove-CsClsConfiguration -Identity <scope and name>

    Par exemple, pour supprimer une configuration de service de journalisation centralisée que vous avez créée pour augmenter la durée de substitution du fichier journal, augmentez la taille du fichier journal de substitution et définissez l’emplacement du cache de fichier journal sur un partage réseau comme suit :

    Remove-CsClsConfiguration -Identity "site:Redmond"

    Remarque

    Il s’agit de la nouvelle configuration qui a été créée dans la procédure « Pour créer une configuration de service de journalisation centralisée ».

Si vous choisissez de supprimer une configuration au niveau du site, le site utilisera les paramètres globaux.