Remove-CsTestDevice
Dernière rubrique modifiée : 2012-03-27
Supprime les périphériques de test spécifiés pour la gestion des mises à jour des périphériques. Les périphériques de test permettent aux administrateurs de tester les mises à jour des microprogrammes avant qu’elles soient appliquées à l’ensemble des périphériques d’une organisation.
Syntaxe
Remove-CsTestDevice -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
En identifiant les téléphones ou autres périphériques spécifiques compatibles avec Microsoft Lync 2010 Phone Edition comme étant des périphériques de test, les administrateurs peuvent vérifier et approuver les mises à jour des microprogrammes avant que ces dernières soient appliquées à tous les périphériques concernés de l’organisation. Lorsque les règles de mise à jour des périphériques sont importées vers Microsoft Lync Server 2010, elles sont marquées comme étant « en attente ». Ainsi, les mises à jour correspondant à ces règles ne sont pas automatiquement téléchargées et installées par les périphériques concernés
mais par les périphériques de test uniquement. Le fonctionnement des périphériques de test est le suivant : les nouvelles règles de mise à jour des périphériques sont appliquées aux périphériques de test, permettant ainsi aux administrateurs de vérifier que les mises à jour des microprogrammes fonctionnent comme prévu. Si tel est le cas, les administrateurs peuvent alors marquer les règles comme étant approuvées. Ces dernières sont ensuite téléchargées et installées par tous les périphériques concernés de l’organisation.
Les périphériques de test sont des périphériques matériels qui exécutent Lync 2010 Phone Edition. Ces périphériques sont créés à l’aide de la cmdlet New-CsTestDevice. Une fois créés, ils peuvent par la suite être supprimés à l’aide de la cmdlet Remove-CsTestDevice. Notez que la suppression du périphérique en tant que périphérique de test n’affecte pas le périphérique en lui-même. Ainsi, vous pourrez toujours utiliser votre téléphone compatible avec Lync 2010 Phone Edition pour accéder à Lync Server 2010. à la différence près que, le périphérique n’étant plus un périphérique de test, il ne télécharge plus les règles de mise à jour dont l’état est En attente. Le périphérique attend en effet que les règles soient approuvées avant de les télécharger et de les installer.
Remove-CsTestDevice peut servir à supprimer les périphériques de test individuels configurés au niveau de l’étendue globale ou de l’étendue Site. Vous pouvez également utiliser cette cmdlet pour supprimer tous les périphériques de test configurés pour une étendue donné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 Remove-CsTestDevice : 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-CsTestDevice"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Indique l’identité du périphérique de test à supprimer. Pour supprimer un périphérique spécifique, incluez à la fois l’étendue (par exemple, site:Redmond) et le nom du périphérique. Par exemple : -Identity "site:Redmond/UCPhoneTest". Pour supprimer tous les périphériques d’un site en particulier, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Les périphériques de test peuvent également être supprimés de l’étendue globale. Il est impossible de supprimer la collection globale de périphériques de test elle-même. Cependant, la commande suivante permet de supprimer tous les périphériques stockés dans la collection globale : Remove-CsTestDevice –Identity global |
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.TestDevice. Remove-CsTestDevice accepte la saisie de données transmises via le pipeline de l’objet périphérique de test.
Types de retours
Remove-CsTestDevice ne retourne aucune valeur ni objet. Au lieu de cela, la cmdlet supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemple
-------------------------- Exemple 1 ------------------------
Remove-CsTestDevice -Identity site:Redmond
La commande ci-dessus supprime tous les périphériques de test du site Redmond. Elle supprime la collection de périphérique, ainsi que les périphériques de test individuels.
-------------------------- Exemple 2 ------------------------
Get-CsTestDevice | Remove-CsTestDevice
La commande illustrée dans l’exemple 2 supprime tous les périphériques de test configurés pour être utilisés dans l’organisation. Pour cela, Get-CsTestDevice retourne toutes les collections de périphériques de test, puis redirige l’ensemble de ces éléments vers Remove-CsTestDevice. Notez que la collection globale de périphériques de test ne peut pas être supprimée. Toutefois, cette commande supprime tous les périphériques de test individuels configurés au niveau global.
-------------------------- Exemple 3 ------------------------
Get-CsTestDevice -Filter "site:" | Remove-CsTestDevice
Dans l’exemple 3, tous les périphériques de test configurés au niveau de l’étendue Site sont supprimés. Pour effectuer cette tâche, Get-CsTestDevice et le paramètre Filter sont utilisés pour retourner tous les périphériques de test dont l’identité commence par la valeur de chaîne "site:". Cette collection filtrée est alors redirigée vers Remove-CsTestDevice, qui supprime tous les éléments de la collection.
-------------------------- Exemple 4 ------------------------
Get-CsTestDevice | Where-Object {$_.Name -match "LG-Nortel Phone"} | Remove-CsTestDevice
La commande illustrée dans l’exemple 4 supprime tous les périphériques de test des téléphones LG-Nortel. Pour ce faire, la commande appelle d’abord Get-CsTestDevice pour retourner tous les périphériques de test configurés pour être utilisés dans l’organisation. Cette information est ensuite redirigée vers la cmdlet Where-Object qui utilise l’opérateur -match afin de retourner les périphériques contenant la valeur de chaîne "LG-Nortel" dans la propriété Name. Tout périphérique de test correspondant à ce critère est ensuite supprimé à l’aide de Remove-CsTestDevice.