Partager via

  • Article

Set-CsDeviceUpdateConfiguration

 

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

Modifie une collection de paramètres de configuration du service Web de mise à jour des périphériques. Ces paramètres contribuent à gérer le service Web de mise à jour des périphériques, composant Microsoft Lync Server 2010 qui permet aux administrateurs de distribuer les mises à jour de microprogrammes aux téléphones et autres périphériques exécutant Microsoft Lync 2010 Phone Edition.

Syntaxe

Set-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsDeviceUpdateConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Le service Web de mise à jour des périphériques permet aux administrateurs de distribuer les mises à jour de microprogrammes aux périphériques équipés de Microsoft Lync 2010 Phone Edition. Régulièrement, les administrateurs téléchargent un ensemble de règles de mise à jour des périphériques pour Microsoft Lync Server 2010. Une fois ces règles testées et approuvées, elles peuvent ensuite être appliquées aux périphériques appropriés à mesure qu’ils se connectent au système. Les périphériques recherchent les mises à jour lorsqu’ils sont mis sous tension, puis une nouvelle fois lorsqu’un utilisateur se connecte. Par la suite, ils recherchent les mises à jour toutes les 24 heures.

Les paramètres de configuration de mise à jour des périphériques peuvent être appliqués soit à l’étendue globale soit à l’étendue du site. La cmdlet Set-CsDeviceUpdateConfiguration vous permet de modifier cette collection de paramètres. Vous pouvez par exemple utiliser cette cmdlet pour modifier la durée de conservation du fichier journal avant sa suppression par le système.

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-CsDeviceUpdateConfiguration : 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-CsDeviceUpdateConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres de configuration de mise à jour du périphérique à modifier. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour renvoyer aux paramètres du site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez une identité.

Instance

Facultatif

Objet DeviceUpdateSettings

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

LogCleanUpInterval

Facultatif

Timespan

Spécifie la durée pendant laquelle le fichier journal de mise à jour de périphérique sera conservé avant d’être supprimé par le système.

La valeur doit être saisie au format jj.hh:mm:ss où jj est le jour, hh, les heures, hm, les minutes et hs, les secondes. Pour ne saisir que les jours, vous devez faire suivre la valeur par un point (.).

Valeur minimale : 1.00:00:00 (1 jour)

Valeur maximale : 365.00:00:00 (1 an)

Valeur par défaut : 10.00:00:00 (10 jours)

LogCleanUpTimeOfDay

Facultatif

DateTime

Indique l’heure de la journée pendant lesquelles le système effectue un contrôle pour savoir si les fichiers arrivés à expiration doivent être supprimés. (Les fichiers journaux expirés sont tous les fichiers plus anciens que la valeur spécifiée par la propriété LogCleanupInterval.)

La valeur passé au paramètre LogCleanupTimeOfDay doit être au format 24 heures hh:mm où hh représente les heures et les mm représente les minutes. Dans ce format, minuit est représenté sous la forme 00:00, 8:30:00 est représenté sous la forme 8:30 et 12:52:00 sous la forme 23:52.

LogFlushInterval

Facultatif

TimeSpan

Indique la fréquence à laquelle les informations présentes dans la mémoire cache du fichier journal sont enregistrées dans le fichier journal effectif. Par défaut, les informations de mise à jour des périphériques ne sont pas immédiatement enregistrées dans le fichier journal, mais plutôt mises en cache jusqu’à ce que : 1) l’intervalle de nettoyage du fichier journal ait expiré ou, 2) la mémoire cache ait atteint sa taille maximale. Si cette valeur est configurée sur 10 minutes (00:10:00), alors l’information du cache sera enregistrée dans le fichier journal toutes les 10 minutes. Une fois les données journalisées, la mémoire cache est nettoyée.

La valeur doit être saisie au format hh:mm:ss où hh sont les heures, mm, les minutes et ss, les secondes.

Valeur minimale : 00:01:00 (1 minute)

Valeur maximale : 1:00:00 (1 heure)

Valeur par défaut : 00:05:00

MaxLogCacheLimit

Facultatif

Entier

Indique la quantité maximale d’informations (en octets) pouvant être conservée dans la mémoire cache du fichier journal avant le nettoyage du cache et l’enregistrement des données dans le fichier journal. Par défaut, les fichiers journaux sont « nettoyés » toutes les 5 minutes. (Pour plus d’informations, consultez la description du paramètre LogFlushInterval.) Cependant, si le cache atteint la taille maximale, l’information sera automatiquement enregistrée dans un fichier journal (et la mémoire cache nettoyée) même si l’intervalle de nettoyage du fichier n’a pas encore expiré.

Valeur par défaut : 512000

MaxLogFileSize

Facultatif

Entier

Indique la taille de fichier maximale, en octets, pour un fichier journal individuel. Quand un fichier atteint la taille maximale, le lot de données suivant est automatiquement enregistré dans un nouveau fichier journal. L’ancien fichier journal sera conservé jusqu’à ce que l’intervalle de nettoyage du fichier journal expire.

Valeur par défaut : 1024000

ValidLogFileExtensions

Facultatif

Modificateur de liste PS

Fournit les extensions de fichier journal valides pouvant être utilisées avec le service Web de mise à jour de périphérique. Cette liste peut être modifiée. Cependant, il n’y a aucune raison de le faire, à moins de posséder un périphérique compatible Lync 2010 Phone Edition qui crée des fichiers journaux utilisant une extension de fichier différente.

Valeur par défaut : .dmp, .clg, .clg2, .bak, .kdmp, .dat, .bin, .cat, .xml, .txt, .hex

ValidLogFileTypes

Facultatif

Modificateur de liste PS

Indique les types de fichier journaux conservés dans le système de mise à jour du périphérique. Les types de fichiers par défaut sont les suivants :

Watson. Les fichiers journaux sont générés par un périphérique au cas où le système tomberait en panne.

Config. Profils du appareil de conférence Microsoft RoundTable créés chaque fois que vous configurez un appareil RoundTable

DiagLog. Données d’auto-diagnostic de appareils RoundTable.

CELog. Journaux téléphoniques Lync 2010 contenant les résultats des tests fonctionnels, ainsi que les enregistrements des événements système critiques.

Les types de fichiers supplémentaires peuvent être ajoutés si vous possédez un périphérique compatible Lync 2010 Phone Edition qui crée un type de fichier différent du fichier journal. Vous pouvez également supprimer des fichiers. Par exemple, si vous ne voulez pas enregistrer les fichiers CELog, vous pouvez supprimer le type de fichier CELog.

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.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter 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.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration. Set-CsDeviceUpdateConfiguration accepte les instances transmises via le pipeline de l’objet de configuration de mise à jour des périphériques.

Types de retours

Set-CsDeviceUpdateConfiguration ne retourne ni valeur ni objet. Au lieu de cela, elle configure des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemple

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

Set-CsDeviceUpdateConfiguration -Identity global -MaxLogFileSize 2048000 -MaxLogCacheLimit 1024000

L’exemple 1 montre comment utiliser Set-CsDeviceUpdateConfiguration pour modifier les paramètres de configuration globaux. Dans ce cas, les deux valeurs de propriété sont modifiées : La propriété MaxLogFileSize est configurée pour 2048000 octets et MaxLogCacheLimit pour 1024000 octets.

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

Set-CsDeviceUpdateConfiguration -Identity site:Redmond -LogFlushInterval 00:02:00

La commande précédente modifie la propriété LogFlushInterval existante des paramètres de configuration de mise à jour de périphérique avec l’identité site:Redmond. Dans ce cas, le paramètre Identity est utilisé pour spécifier les paramètres du site Redmond et le paramètre LogFlushInterval pour indiquer la valeur de la propriété qui doit être modifiée. Dans ce cas, LogFlushInterval est configuré sur 2 minutes (00 heure : 02 minutes: 00 seconde).

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 14.00:00:00

Dans l’exemple 3, tous les paramètres de mise à jour de la configuration du périphérique dans l’organisation sont modifiés pour donner à l’intervalle de nettoyage LogCleanUpInterval la valeur 14 jours. Pour ce faire, Get-CsDeviceUpdateConfiguration est d’abord utilisé pour récupérer la collection de tous les paramètres de configuration de la mise à jour du périphérique en cours d’utilisation. Cette collection est ensuite acheminée vers Set-CsDeviceUpdateConfiguration qu utilise le paramètre LogCleanUpInterval pour fixer l’intervalle de nettoyage de chaque élément dans la collection à 14 jours (14 jours : 00 heure : 00 minute : 00 seconde).

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 20.00:00:00

L’exemple 4 illustre la manière de modifier une valeur de propriété pour tous les paramètres de configuration de mise à jour du périphérique configurés dans l’étendue du site. Dans ce cas, la commande fixe l’intervalle LogCleanUpInterval à 20 jours (20 jours : 00 heure : 00 minute : 00 seconde). Afin d’effectuer cette tâche, la cmdlet Get-CsDeviceUpdateConfiguration est utilisée, ainsi que le paramètre Filter. La valeur de filtre « site:* » limite les données retournées dont l’identité commence par la valeur de chaîne « site: ». Cette collection filtrée est ensuite acheminée vers Set-CsDeviceUpdateConfiguration, ce qui modifie la valeur de l’intervalle de nettoyage du fichier journal pour chaque élément dans la collection.

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -ValidLogFileTypes @{Remove="CELog"}

La commande précédente supprime CELog de la liste des types de fichier journal valides utilisés par les paramètres de configuration de la mise à jour du périphérique. Pour cette commande, Get-CsDeviceUpdateConfiguration est d’abord utilisée pour récupérer la collection de tous les paramètres de configuration de la mise à jour de périphériques dans l’organisation. La collection est ensuite acheminée vers Set-CsDeviceUpdateConfiguration qui utilise le paramètre ValidLogFileTypes afin de supprimer CELog de la liste des types de fichiers journaux valides. La valeur de paramètre transférée à ValidLogFileTypes, @{Remove="CELog"} donne l’instruction à Set-CsDeviceUpdateConfiguration de supprimer CELog du groupe de types de fichier valides. Pour supprimer des types de fichiers multiples en une seule commande, il suffit d’inclure les types supplémentaires dans la liste CSV. Par exemple :

@{Remove="CELog","Watson"}