Reset-CsDeviceUpdateRule
Dernière rubrique modifiée : 2012-03-25
Rejette une règle de mise à jour des périphériques qui a été importée dans le système.
Syntaxe
Reset-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Reset-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 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 sont 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.
Chaque nouvelle règle de mise à jour des périphériques ajoutée au système est mise « 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. Toutefois, elle ne sera pas généralement téléchargée ni installée par des périphériques clients. Cela vous permet de tester les mises à jour et de vérifier l’absence d’effets nuisibles avant qu’elles ne soient mises à 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.
Parallèlement, les administrateurs peuvent conclure qu’une mise à jour donnée ne doit pas être utilisée dans l’organisation (par exemple, la mise à jour peut provoquer un conflit avec un logiciel interne). Dans ce cas, ils peuvent utiliser la cmdlet Reset-CsDeviceUpdateRule pour rejeter la mise à jour. Lorsque cela se produit, le paramètre PendingVersion de la règle de mise à jour est défini sur une valeur null. En retour, cela signifie que les périphériques de test qui se connectent au système désinstalleront la mise à jour et réinstalleront sa version approuvée. De plus, étant donné que la mise à jour n’a jamais été approuvée, cela signifie qu’elle ne sera jamais installée par aucun autre dispositif que les périphériques de test. Il n’y aura donc aucun impact sur les utilisateurs en général.
La cmdlet Reset-CsDeviceUpdateRule peut être uniquement utilisée pour les règles de mise à jour de périphériques à l’état d’attente. Si une règle a déjà été approuvée, vous devrez utiliser la cmdlet Restore-CsDeviceUpdateRule pour restaurer le déploiement de la mise à jour du périphérique.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Reset-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 "Reset-CsDeviceUpdateRule"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
Chaîne |
Identificateur unique de la règle de mise à jour de périphériques réinitialisée. L’identité d’une règle de mise à jour de périphériques est constitué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 de périphériques configurée pour le site de Redmond comportera une identité similaire à celle qui suit : « service:WebServer:atl-cs-oo1.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 ». |
Instance |
Facultatif |
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 les invites de confirmation ou les messages d’erreur récupérable qui peuvent s’afficher lors de l’exécution de la cmdlet. |
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. Reset-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, Reset-CsDeviceUpdateRule réinitialise des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.
Exemple
-------------------------- Exemple 1 ------------------------
Reset-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9
La commande illustrée dans l’exemple 1 réinitialise la règle de mise à jour des périphériques d5ce3c10-2588-420a-82ac-dc2d9b1222ff9, disponible sur le service WebServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 2 ------------------------
Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com* | Reset-CsDeviceUpdateRule
La commande précédente réinitialise toutes les règles de mise à jour de périphériques qui ont été configurées pour le service WebServer:atl-cs-001.litwareinc.com. Celle opération est effectuée en appelant d’abord Get-CsDeviceUpdateRule avec le paramètre Filter. La valeur de filtre « WebServer:atl-cs-001.litwareinc.com* » garantit que seules les règles dont l’identité commence par les caractères « WebServer:atl-cs-001.litwareinc.com » sont renvoyées (par définition, il s’agit de toutes les règles de mise à jour de 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 Reset-CsDeviceUpdateRule, qui réinitialise chaque règle de la collection.
-------------------------- Exemple 3 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Reset-CsDeviceUpdateRule
La commande illustrée dans l’exemple 3 réinitialise toutes les règles de mise à jour de périphériques pour la marque 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. La collection filtrée est alors redirigée vers Reset-CsDeviceUpdateRule, qui procède à la réinitialisation de toutes les règles contenues dans la collection.
Voir aussi
Autres ressources
Approve-CsDeviceUpdateRule
Get-CsDeviceUpdateRule
Remove-CsDeviceUpdateRule
Restore-CsDeviceUpdateRule