Partager via

  • Article

New-CsDeviceUpdateConfiguration

 

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

Crée une nouvelle instance des paramètres de configuration de la mise à jour des périphériques. Ces paramètres sont utilisés pour 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

New-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 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 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 la mise à jour des périphériques qui sont utilisés pour gérer le service Web de mise à jour des périphériques peuvent être attribués au niveau de l’étendue globale ou de l’étendue Site. Pour créer une collection de paramètres pour un site, utilisez la cmdlet New-CsDeviceUpdateConfiguration. Notez que vous ne pouvez créer des paramètres qu’au niveau de l’étendue Site ; si vous essayez de créer une collection de paramètres au niveau de l’étendue globale, votre commande échouera. De plus, votre commande échouera si vous essayez de créer une collection de paramètres pour le site Redmond, par exemple, alors qu’il héberge déjà une collection de paramètres de configuration de la mise à jour des périphériques. En effet, vous ne pouvez avoir qu’une collection de paramètres de configuration de la mise à jour des périphériques par site.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Indique l’identité des nouveaux paramètres de configuration de la mise à jour des périphériques. Étant donné que de nouveaux paramètres ne peuvent être créés qu’au niveau de l’étendue Site, la propriété Identity sera du type : -Identity "site:Redmond".

LogCleanUpInterval

Facultatif

TimeSpan

Spécifie la période pendant laquelle un fichier journal de mise à jour des périphériques est 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, mm, les minutes et ss, les secondes. Pour entrer uniquement des jours, vous devez faire suivre la valeur d’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 du jour à laquelle le système vérifie si des fichiers journaux ayant expiré doivent être supprimés. (Les fichiers journaux à expiration 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, 08:30:00 est représenté sous la forme 8:30 et 11:52:00 sous la forme 23:52.

LogFlushInterval

Facultatif

TimeSpan

Indique la fréquence à laquelle les informations stockées dans le cache du fichier journal doivent être écrites vers le fichier journal réel. 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 vidage du journal expire ou 2) le cache atteigne 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, le cache est effacé.

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

UInt32

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 vidés toutes les X 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

UInt32

Indique la taille maximale, en octets, d’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. Le fichier journal précédent sera conservé jusqu’à expiration de l’intervalle de nettoyage du journal.

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 des périphériques. Cette liste peut être modifiée, cependant, il n’y a aucune raison pour modifier la liste à moins que vous ne possédiez un périphérique 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 fichiers journaux conservés par le système de mise à jour des périphériques. Les types de fichiers par défaut incluent les suivants :

Watson. Les fichiers journaux sont générés par un périphérique si le système cesse de répondre.

Config. Profils 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 pour téléphones Lync 2010 contenant les résultats des tests fonctionnels et 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 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 souhaitez pas stocker les fichiers CELog, vous pouvez supprimer le type de fichier correspondant.

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.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

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

Types de retours

La cmdlet New-CsDeviceUpdateConfiguration crée des instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemple

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond

La commande illustrée dans l’exemple 1 crée un jeu de paramètres de configuration de la mise à jour des périphériques avec la propriété Identity site:Redmond. Étant donné qu’aucun paramètre n’est inclus dans la commande, cette nouvelle collection de paramètres de configuration utilisera les valeurs par défaut pour chaque propriété.

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond -MaxLogFileSize 204800 -LogCleanUpInterval 7.00:00:00

La commande illustrée ci-dessus crée également un jeu de paramètres de configuration de la mise à jour des périphériques avec la propriété Identity site:Redmond. Dans ce cas, deux paramètres supplémentaires sont utilisés pour personnaliser les nouveaux paramètres : MaxLogFileSize est utilisé pour définir la taille de journal maximale sur 2 048 000 octets et LogCleanUpInterval est utilisé pour définir l’intervalle de nettoyage de journal sur 7 jours (7 jours : 00 heure : 00 minute : 00 seconde).