Partager via

  • Article

Get-CsDeviceUpdateConfiguration

 

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

Retourne des informations sur les paramètres de configuration de la mise à jour des périphériques déployés dans votre organisation. Ces paramètres aident à 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 à des téléphones et autres périphériques dotés de Microsoft Lync 2010 Phone Edition.

Syntaxe

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

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

Le service Web de mise à jour des périphériques est administré au moyen des paramètres de configuration des périphériques. Ces paramètres peuvent être appliqués au niveau de l’étendue globale ou de l’étendue Site. Vous pouvez utiliser la cmdlet Get-CsDeviceUpdateConfiguration pour retourner des informations sur les paramètres de configuration de mise à jour des périphériques actuellement utilisés dans votre 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-CsDeviceUpdateConfiguration : 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 "Approve-CsDeviceUpdateRule"}

Paramètres

Parameter Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Indique l’identité des paramètres de configuration de mise à jour des périphériques à récupérer. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour renvoyer aux paramètres de 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é. Si vous devez utiliser des caractères génériques, servez-vous du paramètre Filter.

Filter

Facultatif

Filtre XdsIdentity

Fournit un moyen d’utiliser des caractères génériques lorsque vous spécifiez des paramètres de configuration de mise à jour des périphériques. Par exemple, pour retourner une collection de tous les paramètres configurés au niveau de l’étendue Site, utilisez cette syntaxe : -Filter "site:*". Pour retourner tous les paramètres contenant le terme « EMEA » dans leur identité, utilisez cette syntaxe : -Filter "*EMEA*". Notez que le paramètre Filter agit uniquement sur l’identité des paramètres ; vous ne pouvez pas filtrer d’autres propriétés de configuration de mise à jour des périphériques.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les données de configuration de mise à jour des périphériques à 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-CsDeviceUpdateConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsDeviceUpdateConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemple

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

Get-CsDeviceUpdateConfiguration

La commande présentée dans l’exemple 1 retourne une collection de tous les paramètres de configuration de mise à jour des périphériques actuellement utilisés dans votre organisation. Lorsque vous appelez la cmdlet Get-CsDeviceUpdateConfiguration sans aucun paramètre supplémentaire, tous les paramètres de configuration de mise à jour des périphériques actuellement utilisés sont retournés.

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

Get-CsDeviceUpdateConfiguration -Identity Global

Dans l’exemple 2, des informations sont retournées uniquement pour les paramètres globaux de configuration de mise à jour des périphériques.

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

Get-CsDeviceUpdateConfiguration -Filter site:*

L’exemple 3 montre comment utiliser le paramètre Filter. La valeur de filtre « site:* » retourne une collection de tous les paramètres de configuration de mise à jour des périphériques au niveau de l’étendue Site ; cela est dû au fait que ces paramètres ont tous une identité qui commence par la valeur de chaîne « site: ».

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -gt 2048000}

La commande ci-dessus retourne tous les paramètres de configuration de mise à jour des périphériques dont la propriété MaxLogFileSize est supérieure à 2 048 000 octets. Pour cela, la cmdlet Get-CsDeviceUpdateConfiguration est d’abord utilisée pour retourner une collection de tous les paramètres de configuration de mise à jour des périphériques actuellement utilisés. Cette collection est ensuite redirigée vers Where-Object qui sélectionne uniquement les paramètres dont la propriété MaxLogFileSize est supérieure à 2 048 000.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.ValidLogFileTypes -like "*Watson*"}

La commande présentée dans l’exemple 5 retourne tous les paramètres de configuration de mise à jour des périphériques comportant « Watson » comme type de fichier journal valide. Pour effectuer cette tâche, la cmdlet Get-CsDeviceUpdateConfiguration est d’abord utilisée pour retourner une collection de tous les paramètres de configuration de mise à jour des périphériques. Cette collection est ensuite redirigée vers Where-Object qui sélectionne uniquement les paramètres de périphériques comportant « Watson » ($_.ValidLogFileTypes -like "*Watson*") dans leur liste de types de fichier journal valides.