Partager via

  • Article

Get-CsDeviceUpdateRule

 

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

Renvoie des informations sur les règles de mise à jour des périphériques configurées pour être utilisées dans votre organisation. Les règles de mise à jour des périphériques sont utilisées pour associer des mises à jour de microprogrammes à des périphériques qui exécutent Microsoft Lync 2010 Phone Edition.

Syntaxe

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

Get-CsDeviceUpdateRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Microsoft Lync Server 2010 utilise des règles de mise à jour des périphériques comme moyen de fournir des mises à jour des microprogrammes aux périphériques dotés de Lync 2010 Phone Edition. Régulièrement, les administrateurs chargent un ensemble de règles de mise à jour des périphériques dans Lync Server 2010 ; une fois ces règles testées et approuvées, elles sont ensuite automatiquement téléchargées et appliquées aux périphériques appropriés à mesure qu’ils se connectent au système. Par défaut, les périphériques vérifient les nouvelles règles de mise à jour chaque fois qu’ils sont mis sous tension et connectés à Lync Server. Les périphériques vérifient également les mises à jour toutes les 24 heures, après la première connexion.

Les règles de mise à jour des périphériques peuvent être importées (et appliquées) dans le service services Web. La cmdlet Get-CsDeviceUpdateRule vous permet de renvoyer des informations sur les règles de mise à jour de périphériques qui ont été importées pour être utilisées 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-CsDeviceUpdateRule : 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 "Get-CsDeviceUpdateRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la règle de mise à jour des périphériques. L’identité d’une règle de mise à jour de périphériques est constituée de deux parties : l’étendue Service où la règle a été appliquée (par exemple, service:WebServer:atl-cs-001.litwareinc.com) et l’identificateur unique global (GUID) pré-affecté à la règle (par exemple, d5ce3c10-2588-420a-82ac-dc2d9b1222ff9). En fonction de ces éléments de données, l’identité d’une règle de mise à jour de périphériques se présente comme suit : "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Les caractères génériques ne sont pas autorisés pour spécifier une identité. Utilisez le paramètre Filter si vous souhaitez utiliser des caractères génériques lors de la spécification d’une règle.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques lors de la spécification de l’identité d’une ou de plusieurs règles de mise à jour des périphériques. Par exemple, pour renvoyer toutes les règles de mise à jour des périphériques pour WebServer:atl-cs-001.litwareinc.com, utilisez la valeur de filtre suivante : « service:WebServer:atl-cs-001.litwareinc.com* ».

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données de la règle de mise à jour des périphériques à partir du réplica local du magasin central de gestion et non du magasin central de gestion lui-même.

Types d’entrées

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

Types de retours

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

Exemple

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

Get-CsDeviceUpdateRule

La commande ci-dessus retourne des informations sur toutes les règles de mise à jour de périphériques appliquées dans votre organisation. L’appel de Get-CsDeviceUpdateRule sans aucun paramètre supplémentaire retourne toujours une collection complète de règles de mise à jour de périphériques.

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

Get-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9

La commande présentée dans l’exemple 2 retourne des informations sur la règle de mise à jour de périphérique dont l’identité est « WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 ».

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

Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com*

L’exemple 3 retourne des informations sur toutes les règles de mise à jour de périphériques configurées pour le service WebServer:atl-cs-001.litwareinc.com. Pour accomplir cette tâche, le paramètre Filter est associé à la valeur de filtre « WebServer:atl-cs-001.litwareinc.com * ». Ce filtre limite les données retournées aux règles de mise à jour de périphériques dont l’identité commence par la valeur de chaîne « service:WebServer:atl-cs-001.litwareinc.com ».

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

Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"}

La commande ci-dessus retourne toutes les règles de mise à jour de périphériques dont la propriété Brand est égale à « LG-Nortel ». Pour cela, la cmdlet Get-CsDeviceUpdateRule est appelée pour retourner une collection de toutes les règles de mise à jour des périphériques dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les règles dont la propriété Brand est égale à « LG-Nortel ».

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

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}

L’exemple 5 retourne une collection de toutes les règles de mise à jour de périphériques qui n’ont pas été approuvées. Cette opération est effectuée en exécutant la cmdlet Get-CsDeviceUpdateRules pour retourner une collection de toutes les règles, puis en redirigeant celle-ci vers Where-Object. La cmdlet Where-Object sélectionne ensuite uniquement les règles dont la propriété Approved équivaut à une valeur Null. Si la propriété Approved est Null, cela signifie que ces règles ne sont pas approuvées.

-------------------------- Exemple 6 ------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}

La commande présentée ci-dessus retourne une collection de toutes les règles de mise à jour de périphériques répondant à deux critères : la règle a été approuvée et concerne les périphériques LG-Nortel. Pour accomplir cette tâche, la cmdlet Get-CsDeviceUpdateRule est appelée pour retourner une collection de toutes les règles de mise à jour des périphériques dans l’organisation. Cette collection est ensuite redirigée vers Where-Object qui filtre la collection d’après deux critères : la propriété Approved ne doit pas être Null (c’est-à-dire, elle doit comporter une valeur quelconque) et la propriété Brand doit être égale à « LG-Nortel ».