Set-CsTestDevice
Dernière rubrique modifiée : 2012-03-25
Modifie un ou plusieurs périphériques de test de gestion des mises à jour de périphériques qui ont été configurés pour être utilisés dans votre organisation. Les périphériques de test permettent aux administrateurs de tester les mises à jour de microprogrammes avant qu’elles ne soient distribuées à tous les périphériques d’une organisation.
Syntaxe
Set-CsTestDevice [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-WhatIf [<SwitchParameter>]]
Set-CsTestDevice [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
Description détaillée
En identifiant les téléphones ou autres périphériques 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 à 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 affectés.
mais par tous les périphériques de test appropriés. 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, ces administrateurs peuvent alors marquer les règles comme approuvées, qui sont ensuite téléchargées et installées par tous les périphériques appropriés de l’organisation.
Les périphériques de test sont créés à l’aide de la cmdlet New-CsTestDevice. Une fois un périphérique de test créé, vous pouvez utiliser la cmdlet Set-CsTestDevice pour modifier l’identificateur et/ou le paramètre IdentifierType de ce périphérique ou de tout autre périphérique de test.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsTestDevice"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Indique l’identité du périphérique de test à modifier. Par exemple : -Identity site:Redmond/UCPhoneTestDevice. Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité. |
Instance |
Facultatif |
Objet de périphérique de test |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
Identifier |
Obligatoire |
Chaîne |
Selon la valeur du paramètre IdentifierType, indique l’adresse MAC (Media Access Control) ou le numéro de série du nouveau périphérique de test. Les numéros de série peuvent être spécifiés à l’aide de chiffres, de lettres, de tirets et de traits de soulignement ; par exemple : -Identifier « AB37_679e » Les adresses MAC doivent être spécifiées sous la forme de 6 paires ou plus de deux caractères ; selon l’adresse MAC, ces paires peuvent être une valeur de chaîne unique ou être séparées au moyen de tirets ou de double-points. (Notez que les adresses MAC peuvent inclure des lettres et/ou des chiffres.) Chacune des adresses MAC suivantes est valide : 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 Une adresse MAC telle que 01-02-03-04-05 sera refusée car elle comprend moins de six paires de deux caractères. |
IdentifierType |
Obligatoire |
Chaîne |
Indique si le périphérique de test sera identifié de façon exclusive en fonction de son adresse MAC ou de son numéro de série. Pour identifier un périphérique par son adresse MAC, définissez IdentifierType sur MACAddress. Pour identifier un périphérique par son numéro de série, définissez IdentifierType sur SerialNumber. MACAddress et SerialNumber sont les seules valeurs autorisées. |
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. Set-CsTestDevice accepte la saisie de données transmises via le pipeline de l’objet de périphérique de test.
Types de retours
Set-CsTestDevice ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -Identifier "09768-ABDR-83295"
La commande précédente modifie la propriété Identifier du périphérique de test appelé UCPhone qui est affecté au site de Redmond.
-------------------------- Exemple 2 ------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "09768-ABDR-83295"
La commande illustrée dans l’exemple 2 modifie également le périphérique de test appelé UCPhone qui est affecté au site de Redmond. Dans ce cas cependant, la commande spécifie non seulement un nouvel identificateur, mais affecte également un nouveau paramètre IdentifierType : SerialNumber.