Get-CsTestDevice
Dernière rubrique modifiée : 2012-03-23
Récupère les informations relatives aux périphériques de test de la gestion des mises à jour de périphériques configurés et utilisés dans votre organisation. Les périphériques de test permettent de tester des mises à jour de microprogrammes avant qu’elles ne soient distribuées à tous les périphériques d’une organisation.
Syntaxe
Get-CsTestDevice [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsTestDevice [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
En identifiant les téléphones ou autres périphériques compatibles spécifiques de 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 aux 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 affectés.
Ces règles « en attente » sont plutôt téléchargées et installées par les périphériques de test désignés. Les périphériques de test fonctionnent comme suit : 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 c’est bien le cas, ces administrateurs peuvent ensuite certifier que ces règles ont été approuvées, pour qu’elles soient ensuite téléchargées et installées par les périphériques pertinents dans l’organisation.
Les périphériques de test peuvent ensuite être assignés soit à l’étendue globale soit celle des sites. Vous pouvez utiliser la cmdlet Get-CsTestDevice pour extraire des informations sur les stratégies de périphériques de test actuellement configurées pour être utilisées dans votre organisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsTestDevice : RTCUniversalUserAdmins, 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 "Get-CsTestDevice"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Indique l’identité du périphérique de test dont les informations doivent être renvoyées. Pour renvoyer à un périphérique individuel appelé UCPhone enregistré dans la collection globale, utilisez cette syntaxe : -Identity global/UCPhone. Pour renvoyer à un périphérique dans une collection configurée au niveau du site, utilisez une syntaxe similaire à ce qui suit : -Identity site:Redmond/UCPhone. Pour faire référence à une collection entière, laissez de côté le nom du périphérique. Par exemple, cette syntaxe retourne tous les périphériques de test configurés pour le site Redmond: -Identity site:Redmond. Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez une identité. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser les caractères génériques pour spécifier un périphérique de test (ou périphériques) dont les informations doivent être renvoyées. Par exemple, pour retourner toutes les collections de périphérique de test configurées au niveau de l’étendue Site, utilisez cette syntaxe : -Filter "site:*". Pour retourner tous les périphériques qui comportent le terme « EMEA » dans leur identité, utilisez cette syntaxe : -Filter "*EMEA*". Notez que Filter influe uniquement sur l’identité de la collection de périphériques de test. Vous ne pouvez pas filtrer d’autres propriétés de collection. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données de périphériques de test à partir du réplica local du magasin central de gestion et non du magasin central de gestion lui-même. |
Types d’entrées
Aucun. Get-CsTestDevice n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsTestDevice retourne une ou plusieurs instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsTestDevice
L’exemple 1 retourne tous les périphériques de test dans l’organisation. Le fait d’appeler Get-CsTestDevice sans aucun paramètre supplémentaire retourne tous les périphériques de test utilisés actuellement.
-------------------------- Exemple 2 --------------------------
Get-CsTestDevice -Identity site:Redmond/UCPhone
L‘exemple précédant retourne les informations du périphérique de test appelé UCPhone assigné au site Redmond.
-------------------------- Exemple 3 --------------------------
Get-CsTestDevice -Identity site:Redmond
Dans l’exemple 3, cette syntaxe retourne les informations de tous les périphériques de test configurés pour le site Redmond:
-------------------------- Exemple 4 --------------------------
Get-CsTestDevice -Filter site:*
La commande précédente retourne tous les périphériques de test configurés dans l’étendue du site. Pour ce faire, la commande utilise le paramètre Filter. La valeur de filtre « site:* » limite les données renvoyées aux périphériques de test ayant une identité qui commence par la valeur de chaîne « site ».