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

Dernière modification de la rubrique : 2014-02-04

Le service de journalisation centralisé peut être exécuté sur une étendue qui inclut un ordinateur unique, un pool d’ordinateurs, à l’échelle d’un site (c’est-à-dire 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 (c’est-à-dire, à tous les ordinateurs et groupes de votre déploiement).

Pour configurer l’étendue du service de journalisation centralisé à l’aide de Lync Server Management Shell, vous devez être membre des groupes de sécurité CsAdministrator ou CsServerAdministrator de contrôle d’accès basé sur les rôles (RBAC), ou un rôle RBAC personnalisé qui contient l’un de ces deux groupes. Pour renvoyer la liste de tous les rôles RBAC attribués à cette applet de commande (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"}

Notes

Windows PowerShell offre des options supplémentaires et des 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 le CLSController. Windows PowerShell n’est pas limité uniquement à la commande disponible sur le processeur de commande du CLSController et fournit un ensemble de commandes plus vastes et un ensemble d’options plus riche. Par exemple, CLSController.exe vous permet d’obtenir des options d’étendue pour – ordinateurs et – pools. Windows PowerShell vous permet d’indiquer des ordinateurs ou des pools dans la plupart des commandes, et lorsque vous définissez de nouveaux scénarios (CLSController possède un nombre limité de scénarios qui ne peuvent pas être modifiés 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 pour un site ou une é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 complète 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. À la différence des applets de commande Windows PowerShell, CLSController ne peut pas définir de nouveaux scénarios, gérer l’étendue au niveau d’un site ou d’un niveau global et de nombreuses autres limitations d’un jeu de commandes finies qui ne peuvent pas être configurés dynamiquement. Même si CLSController fournit un moyen pour une exécution rapide, Windows PowerShell fournit un moyen d’étendre la fonctionnalité de service de journalisation centralisée en plus 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.

Conseil

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 service de journalisation de nouvelles, de jeu et de suppression . 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, 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 dans l’emplacement local de l’ordinateur

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, 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 central pour les données. Si vous spécifiez le paramètre-LocalStore, la commande fait référence au LocalStore de l’ordinateur 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, 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, 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 l’étendue d’un site du service de journalisation centralisé à l’aide de Windows PowerShell

  1. Démarrez Lync Server Management Shell : cliquez sur Démarrer, 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" 
    

    Notes

    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, 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]
    

    Notes

    New-CsClsConfiguration permet dʼaccéder à un grand nombre de paramètres de configuration facultatifs. Pour plus d’informations sur les options de configuration, reportez-vous à la rubrique Get-CsClsConfiguration et Présentation des paramètres de configuration du service de journalisation centralisé dans 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é. 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, 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 afin d’augmenter la durée de substitution du fichier journal, augmentez la taille du fichier journal de détournement et définissez l’emplacement du cache du fichier journal sur un partage réseau comme suit :

    Remove-CsClsConfiguration -Identity "site:Redmond"
    

    Notes

    Il s’agit de la nouvelle configuration 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.