Partager via

  • Article

Approve-CsDeviceUpdateRule

 

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

Approuve une règle de mise à jour des périphériques qui a été importée dans le système. Une fois la règle de mise à jour des périphériques approuvée, la mise à jour correspondante est automatiquement téléchargée et installée par les périphériques clients concernés par la mise à jour.

Syntaxe

Approve-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Approve-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<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 2010. Les périphériques vérifient également les mises à jour toutes les 24 heures, après la première connexion.

Chaque nouvelle règle de mise à jour des périphériques ajoutée au système est marquée « En attente ». Cela signifie que la mise à jour sera téléchargée et installée par les périphériques de test appropriés ; cependant, elle ne le sera pas par les périphériques clients en général. Cela vous donne la possibilité de tester les mises à jour et de vous assurer qu’il n’y a pas d’effets négatifs avant leur distribution à grande échelle. Dès que vous êtes sûr que la mise à jour a passé vos tests avec succès et qu’elle fonctionnera pour votre organisation, vous pouvez alors utiliser Approve-CsDeviceUpdateRule pour l’approuver.

Lorsque vous approuvez une mise à jour, la version PendingVersion de la règle de mise à jour associée est affectée à la version ApprovedVersion, et la propriété PendingVersion est désactivée. Par exemple, supposons que la version PendingVersion d’une nouvelle règle de mise à jour est 1.0.0.1. Après avoir exécuté Approve-CsDeviceUpdateRule, la version PendingVersion sera définie sur une valeur Null, et la version ApprovedVersion sera définie sur 1.0.0.1. À la prochaine connexion d’un périphérique client, celui-ci vérifie automatiquement si les mises à jour récemment approuvées le concernent. Dans l’affirmative, la mise à jour sera automatiquement téléchargée et installée.

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

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique pour la règle de mise à jour des périphériques approuvée. L’identité d’une règle de mise à jour des périphériques est composée de deux parties : service auquel la règle de mise à jour des périphériques a été affectée (par exemple, service:WebServer:atl-cs-001.litwareinc.com) et identificateur global unique (GUID). Par conséquent, une règle de mise à jour des périphériques configurée pour le site de Redmond aura une identité semblable à celle-ci : service:WebServer:atl-cs-001.litwareinc.com /d5ce3c10-2588-420a-82ac-dc2d9b1222ff9.

Instance

Facultatif

Objet DeviceUpdate.Rule

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

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.

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

Objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule. Approve-CsDeviceUpdateRule accepte les instances redirigées de l’objet de règle de mise à jour des périphériques.

Types de retours

Aucun. Au lieu de cela, Approve-CsDeviceUpdateRule approuve des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Exemple

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

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

La commande présentée dans l’exemple 1 approuve la règle de mise à jour des périphériques d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 disponible dans le service WebServer:atl-cs-001.litwareinc.com.

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

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

La commande précédente approuve toutes les règles de mise à jour des périphériques qui ont été configurées pour le service WebServer:atl-cs-001.litwareinc.com. Pour ce faire, la commande appelle d’abord Get-CsDeviceUpdateRule ainsi que le paramètre Filter. La valeur de filtre service:WebServer:atl-cs-001.litwareinc.com* garantit que seules seront retournées les règles dont l’identité commence par la valeur de chaîne "service:WebServer:atl-cs-001.litwareinc.com". (Par définition, ce sont toutes les règles de mise à jour des périphériques qui ont été affectées au service WebServer:atl-cs-001.litwareinc.com.) La collection filtrée est ensuite redirigée vers la cmdlet Approve-CsDeviceUpdateRule, qui approuve chaque règle de la collection.

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

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

La commande présentée dans l’exemple 3 approuve toutes les règles de mise à jour des périphériques pour la marque spécifiée (LG-Nortel). Pour ce faire, la commande appelle d’abord Get-CsDeviceUpdateRule pour retourner une collection de toutes les règles de mise à jour des périphériques actuellement utilisées dans l’organisation. Cette collection est alors redirigée vers la cmdlet Where-Object qui sélectionne uniquement les règles dont la propriété Brand est égale à LG-Nortel. La collection filtrée est ensuite redirigée vers la cmdlet Approve-CsDeviceUpdateRule, qui approuve chaque règle de la collection.