Remove-CsDeviceUpdateRule
Dernière rubrique modifiée : 2012-03-25
Supprime une règle de mise à jour des périphériques configurée pour 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
Remove-CsDeviceUpdateRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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. Les périphériques vérifient également les mises à jour toutes les 24 heures, après la première connexion.
Les administrateurs ne peuvent pas créer leurs propres règles de mise à jour des périphériques. La seule façon de créer ces règles est de télécharger les ensembles de règles sur le site Web de Microsoft et de les importer. Cela signifie que sur la durée, vous êtes susceptible de collecter des règles obsolètes ou inutiles dans votre organisation. (Par exemple, si votre organisation n’utilise plus de téléphones LG-Nortel, vous n’avez plus besoin des mises à jour des microprogrammes de ces périphériques.) Bien que ces règles inutiles ne posent pas de problèmes, elles peuvent compliquer l’administration : exécuter la cmdlet Get-CsDeviceUpdateRule pour renvoyer une collection de l’ensemble des règles de mise à jour de vos périphériques peut apporter de la confusion si la majorité de ces règles ne s’appliquent pas à votre organisation. Pour simplifier la situation, Remove-CsDeviceUpdateRule peut être utilisée pour supprimer toute règle de mise à jour des périphériques (ou ensemble de règles) qui a été importée à des fins d’utilisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsDeviceUpdateRule"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique de la règle de mise à jour des périphériques. L’identité d’une règle de mise à jour des périphériques est composé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 cela, l’identité d’une règle de mise à jour de périphériques donnée prendra une forme similaire à celle-ci : "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é. |
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. Remove-CsDeviceUpdateRule accepte les instances transmises via le pipeline de l’objet de règle de mise à jour.
Types de retours
Remove-CsDeviceUpdateRule ne retourne pas de valeur ni d’objet. Au lieu de cela, la cmdlet supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule.
Exemple
-------------------------- Exemple 1 ------------------------
Remove-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9
La commande ci-dessus supprime la règle de mise à jour des périphériques avec l’identité service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9. Après la suppression de la règle, la mise à jour du microprogramme correspondant ne pourra plus être utilisée.
-------------------------- Exemple 2 ------------------------
Get-CsDeviceUpdateRule | Remove-CsDeviceUpdateRule
La commande illustrée dans l’exemple 2 supprime toutes les règles de mise à jour des périphériques configurées pour votre organisation. Il suffit d’appeler Get-CsDeviceUpdateRule (sans paramètres) pour retourner une collection de toutes les règles de mise à jour des périphériques actuellement utilisées. Cette collection est alors redirigée vers Remove-CsDeviceUpdateRule, qui supprime à son tour chaque règle de la collection.
-------------------------- Exemple 3 ------------------------
Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com* | Remove-CsDeviceUpdateRule
Dans l’exemple 3, toutes les règles de mise à jour des périphériques qui ont été importées dans le service WebServer:atl-cs-001.litwareinc.com sont supprimées. Pour ce faire, la commande utilise d’abord Get-CsDeviceUpdateRule et le paramètre Filter pour récupérer toutes les règles de mise à jour des périphériques dont l’identité commence par la valeur de chaîne « service:WebServer:atl-cs-001.litwareinc.com ». Cette collection est ensuite redirigée vers la cmdlet Remove-CsDeviceUpdateRule qui supprime chaque règle de la collection.
-------------------------- Exemple 4 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Remove-CsDeviceUpdateRule
La commande ci-dessus supprime toutes les règles de mise à jour des périphériques dont la propriété Brand est égale à « LG-Nortel ». Pour ce faire, la cmdlet appelle Get-CsDeviceUpdateRule (sans paramètres) afin de récupérer une collection de toutes les règles de mise à jour des périphériques 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 Remove-CsDeviceUpdateRule, qui supprime chaque règle de la collection.
Voir aussi
Autres ressources
Approve-CsDeviceUpdateRule
Get-CsDeviceUpdateRule
Reset-CsDeviceUpdateRule
Restore-CsDeviceUpdateRule