Partager via

  • Article

Remove-CsDeviceUpdateConfiguration

 

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

Supprime les paramètres de configuration de mise à jour des périphériques spécifiés. Ces paramètres contribuent à gérer le service Web de mise à jour des périphériques, composant Microsoft Lync Server 2010 qui permet aux administrateurs de distribuer les mises à jour de microprogrammes aux téléphones et autres périphériques exécutant Microsoft Lync 2010 Phone Edition.

Syntaxe

Remove-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Le service Web de mise à jour des périphériques permet aux administrateurs de distribuer les mises à jour de microprogrammes aux périphériques équipé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 peuvent ensuite être appliquées aux périphériques appropriés à mesure qu’ils se connectent au système. Les périphériques recherchent les mises à jour lorsqu’ils sont mis sous tension, puis une nouvelle fois lorsqu’un utilisateur se connecte. Par la suite, ils recherchent les mises à jour toutes les 24 heures.

Lync Server utilise des paramètres de configuration de mise à jour des périphériques pour gérer le service Web de mise à jour des périphériques ; ces paramètres de configuration peuvent être appliqués au niveau de l’étendue globale ou Site. Par défaut, les paramètres sont détectés uniquement au niveau de l’étendue globale. Cependant, vous pouvez utiliser la cmdlet New-CsDeviceUpdateConfiguration pour assigner des paramètres personnalisés également au niveau de l’étendue Site.

En outre, vous pouvez utiliser la cmdlet Remove-CsDeviceUpdateConfiguration pour supprimer des paramètres assignés au niveau de l’étendue Site. Lorsque vous exécutez cette cmdlet sur un site, les paramètres de configuration de mise à jour des périphériques assignés à ce site sont supprimés. Vous pouvez également exécuter Remove-CsDeviceUpdateConfiguration sur les paramètres globaux. Dans ce cas toutefois, les paramètres globaux ne sont pas supprimés. Vous ne pouvez pas supprimer les paramètres de configuration de mise à jour des périphériques globaux. Au lieu de cela, les propriétés globales sont réinitialisées à leurs valeurs par défaut. Par exemple, supposons que vous ayez modifié la propriété globale MaxLogCacheLimit en lui attribuant la valeur 1.024.000 octets. Si vous exécutez Remove-CsDeviceUpdateConfiguration sur les paramètres globaux, ces derniers ne seront pas supprimés ; cependant, les propriétés modifiées seront réinitialisées à leurs valeurs par défaut. Cela signifie que MaxLogCacheLimit sera réinitialisé à 512.000 octets.

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-CsDeviceUpdateConfiguration : 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-CsDeviceUpdateConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Indique l’identité des paramètres de configuration de mise à jour des périphériques à supprimer. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour faire référence aux paramètres du site, utilisez une syntaxe de type : -Identity site:Redmond. Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez 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.DeviceUpdateConfiguration. Remove-CsDeviceUpdateConfiguration accepte les instances transmises via le pipeline de l’objet de configuration de mise à jour des périphériques.

Types de retours

Aucun. Au lieu de cela, la cmdlet Remove-CsDeviceUpdateConfiguration supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemple

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

Remove-CsDeviceUpdateConfiguration -Identity global

Dans l’exemple 1, Remove-CsDeviceUpdateConfiguration est utilisé pour « supprimer » les paramètres globaux de configuration de la mise à jour des périphériques. Étant donné que les paramètres globaux ne peuvent pas être supprimés, la commande ne supprimera rien ; cependant, toutes les propriétés des paramètres globaux de configuration de la mise à jour des périphériques seront réinitialisées à leurs valeurs par défaut.

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

Remove-CsDeviceUpdateConfiguration -Identity site:Redmond

La commande ci-dessus supprime les paramètres de configuration de la mise à jour des périphériques dont l’identité est site:Redmond. Dans la mesure où ces paramètres ont été configurés au niveau de l’étendue Site, ils seront supprimés et le site Redmond ne disposera plus de son propre ensemble de paramètres de configuration de la mise à jour des périphériques.

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Remove-CsDeviceUpdateConfiguration

Dans l’exemple 3, tous les paramètres de configuration de la mise à jour des périphériques qui ont été configurés au niveau de l’étendue Site sont supprimés. Pour ce faire, la cmdlet Get-CsDeviceUpdateConfiguration et le paramètre Filter sont utilisés pour retourner tous les paramètres dont l’identité commence par la valeur de chaîne « site: ». Par définition, il s’agit de tous les paramètres configurés au niveau de l’étendue Site. Cette collection est ensuite redirigée vers la cmdlet Remove-CsDeviceUpdateConfiguration, qui supprime chaque élément de la collection.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -lt 1024000} | Remove-CsDeviceUpdateConfiguration

Dans l’exemple 4, tous les paramètres de configuration de la mise à jour des périphériques dont la propriété MaxLogFileSize est supérieure à 1 024 000 octets sont supprimés. Pour effectuer cette tâche, Get-CsDeviceUpdateConfiguration est d’abord appelée pour retourner une collection de tous les paramètres de configuration de la mise à jour des périphériques. Cette collection est redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les paramètres de configuration pour lesquels la propriété MaxLogFileSize est supérieure à 1 024 000 octets. La collection filtrée est ensuite redirigée vers Remove-CsDeviceUpdateConfiguration qui supprime chaque élément dans la collection.