New-CsTestDevice
Dernière rubrique modifiée : 2012-03-26
Crée un périphérique de test spécifié 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
New-CsTestDevice -Identity <XdsIdentity> -Identifier <String> -IdentifierType <MACAddress | SerialNumber> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsTestDevice -Identifier <String> -IdentifierType <MACAddress | SerialNumber> -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<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 à 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 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 créés à l’aide de la cmdlet New-CsTestDevice. Ces périphériques peuvent être configurés au niveau de l’étendue Global ou Site.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 "New-CsTestDevice"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Indique l’identité du nouveau périphérique de test. Une identité se compose de l’étendue à laquelle le périphérique de test doit être affecté (par exemple site:Redmond) et du nom du nouveau périphérique (par exemple, UCPhone). Pour affecter un périphérique de test intitulé UCPhone au site Redmond, le paramètre Identity doit correspondre à la syntaxe suivante : -Identity "site:Redmond/UCPhone". |
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, lettres, tirets et underscores. Exemple : -identificateur AB37_679e Les adresses MAC doivent avoir la forme de six paires ou plus de deux caractères ; selon l’adresse MAC, ces paires peuvent être jointes en une même chaîne ou séparées de tirets ou de deux-points. (Notez que les adresses MAC peuvent inclure des lettres et/ou des chiffres.) Voici des exemples d’adresses MAC : 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 Une adresse MAC comme 01-02-03-04-05 n’est pas acceptée, car elle ne contient pas six paires au moins de deux caractères. |
IdentifierType |
Obligatoire |
Chaîne |
Indique si le périphérique de test sera identifié uniquement par son adresse MAC ou par 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. |
Name |
Facultatif |
Chaîne |
Nom du nouveau périphérique de test (les noms doivent être uniques au sein d’une étendue donnée). Le paramètre Name doit être utilisé uniquement avec le paramètre Parent. |
Parent |
Facultatif |
Chaîne |
Nom de l’étendue (par exemple, site:Redmond) à laquelle le nouveau périphérique de test doit être assigné. Si vous utilisez le paramètre Parent, vous devez alors également appliquer le paramètre Name. Exemple : -Parent site:Redmond –Name UCPhone. Si vous utilisez le paramètre Parent, vous ne devez pas utiliser le paramètre Identity, et inversement. |
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. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
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
Aucun. New-CsTestDevice n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemple
-------------------------- Exemple 1 ------------------------
New-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
La commande ci-dessus crée un périphérique de test (UCPhone) pour le site Redmond. Notez la syntaxe utilisée pour spécifier l’identité du périphérique : étendue du périphérique (site:Redmond) suivie du caractère /, puis du nom du périphérique (UCPhone). Ce périphérique utilise le numéro de série 07823-A345 comme IdentifierType.
-------------------------- Exemple 2 ------------------------
New-CsTestDevice -Parent Redmond -Name UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
La commande illustrée dans l’exemple 2 est une variante de la commande de l’exemple 1. Dans l’exemple 2 cependant, le paramètre Identity n’est pas utilisé. Le paramètre Parent est utilisé à la place pour spécifier l’étendue du nouveau périphérique de test (site:Redmond) et le paramètre Name indique le nom de ce périphérique (UCPhone). La cmdlet New-CsTestDevice tient compte de ces deux valeurs de paramètre et construit l’identité du périphérique de test (site:Redmond/UCPhone) pour vous.