Partager via

  • Article

Restore-CsDeviceUpdateRule

 

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

Vous permet de restaurer une règle de mise à jour des périphériques approuvée pour être utilisée dans l’organisation. Quand vous restaurez une règle de mise à jour de périphérique, la version approuvée de cette règle est réinitialisée pour refléter la mise à jour qui était utilisée avant que la règle soit approuvée. Les périphériques clients qui se connectent au système désinstalleront automatiquement la mise à jour la plus récente, puis téléchargeront et réinstalleront sa version précédente.

Syntaxe

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

Restore-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. Les administrateurs téléchargent périodiquement un groupe de règles de mise à jour de périphérique vers Lync Server 2010. Une fois ces règles testées et approuvées, elles sont automatiquement téléchargées et appliquées aux périphériques qui conviennent la prochaine fois que ces périphériques se connectent au système. Par défaut, les périphériques contrôlent les nouvelles règles de mise à jour chaque fois qu’il sont mis en marche et se connectent à Lync Server. Les périphériques vérifient également les mises à jour toutes les 24 heures, après la connexion initiale.

Chaque nouvelle règle de mise à jour de périphérique ajoutée au système est signalée « en attente ». Cela signifie que la mise à jour sera téléchargée et installée par les périphériques de test concernés. Cependant, elle ne sera en général ni téléchargée ni installée par les périphériques client. Cela vous donne l’occasion de tester les mises à jour et de garantir qu’elles n’auront aucun effet néfaste avant de les mettre à la disposition du public. 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.

Quand vous approuvez une mise à jour, la version en attente de la règle de mise à jour associée est assignée à la version approuvée et la propriété de la version en attente est supprimée. Par exemple, supposons que la version en attente d’une nouvelle mise à jour soit la version 1.0.0.1. Après avoir exécuté Approve-CsDeviceUpdateRule, PendingVersion sera défini sur la valeur Null et ApprovedVersion sur 1.0.0.1. Quand un périphérique client vérifie les mises à jour disponibles, ces dernières sont automatiquement téléchargées et installées.

De plus, toute version précédente de la mise à jour (par exemple, version 1.0.0.0) sera signalée comme la version de restauration. Cette version de la mise à jour restera dans le système et sera utilisée si la nouvelle mise à jour doit être restaurée. Si des problèmes surviennent, les administrateurs seront en mesure d’utiliser la cmdlet Restore-CsDeviceUpdateRule pour restaurer la mise à jour. Dans ce cas, à la prochaine vérification des mises à jour par le périphérique client, ce dernier désinstallera automatiquement la nouvelle mise à jour (version 1.0.0.1) et réinstallera la mise à jour précédente (1.0.0.0).

Notez que cela vaut uniquement si la mise à jour précédente a été installée. Si tel n’est pas le cas, la mise à jour restaurée sera simplement désinstallé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 Restore-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 "Restore-CsDeviceUpdateRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique de la règle de mise à jour de périphérique restaurée. L’identité d’une règle de mise à jour de périphérique 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). Ainsi, une règle de mise à jour configurée pour le site Redmond aura une identité similaire à ceci : 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. Restore-CsDeviceUpdateRule accepte les instances transmises via le pipeline de l’objet de règle de mise à jour.

Types de retours

Aucun. Restore-CsDeviceUpdateRule restaure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Exemple

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

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

La commande illustrée à l’exemple 1 restaure la règle de mise à jour d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 trouvée sur le service WebServer:atl-cs-001.litwareinc.com.

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

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

La commande précédente restaure toutes les règles de mise à jour 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 « WebServer:atl-cs-001.litwareinc.com* » garantit que seules seront renvoyées les règles qui ont une identité commençant par la valeur de chaîne « 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 Restore-CsDeviceUpdateRule, qui réinitialise chaque règle de la collection.

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

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

L’exemple 3 montre comment vous pouvez restaurer toutes les règles de mise à jour de périphérique pour une marque spécifique (LG-Nortel). Pour ce faire, la commande appelle d’abord Get-CsDeviceUpdateRule (sans paramètre supplémentaire) afin de renvoyer une collection de toutes les règles de mise à jour de 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. Cette collection filtrée est alors redirigée vers la cmdlet Restore-CsDeviceUpdateRule qui procède à la restauration de toutes les règles qui y sont contenues.