Import-CsDeviceUpdate
Dernière rubrique modifiée : 2012-03-23
Importe un jeu de règles de mise à jour des périphériques à partir du site Web Microsoft. Les règles de mise à jour des périphériques associent les mises à jour de version de microprogramme aux périphériques matériels qui exécutent Microsoft Lync 2010 Phone Edition.
Syntaxe
Import-CsDeviceUpdate -Identity <XdsIdentity> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
De temps en temps, Microsoft publie un nouveau jeu de règles de mise à jour des périphériques pour Lync 2010 Phone Edition. Ces règles représentent des mises à jour de microprogrammes pour les périphériques qui exécutent Lync 2010 Phone Edition. Une fois que ces règles ont été importées, les administrateurs peuvent tester les mises à jour de microprogramme puis, si le test est réussi, appliquer les mises à jour disponibles à tous les périphériques appropriés utilisés dans l’organisation.
La seule façon de créer de nouvelles règles de mise à jour est de télécharger les packages de mise à jour de Microsoft ; vous ne pouvez pas créer vos propres règles de mise à jour des périphériques. Pour obtenir le dernier jeu de règles de mise à jour des périphériques, rendez-vous sur la page Aide et support du site Web Microsoft et recherchez « Phone Edition ». Téléchargez le package de mise à jour et extrayez les fichiers vers un dossier sur l’ordinateur destiné à contenir les mises à jours. Une fois les fichiers extraits, vous pouvez utiliser la cmdlet Import-CsDeviceUpdate pour importer les règles de mise à jour des périphériques présentes dans le fichier .CAB extrait (nommé UCUpdates.cab).
Comme mentionné préalablement, les mises à jour ne peuvent être chargées que localement ; vous devrez copier UCUpdates.cab sur chaque ordinateur destiné à exécuter les services Web. Gardez également en mémoire que les règles de mise à jour des périphériques ne sont pas répliquées de serveur à serveur. Si vous souhaitez que toutes les règles de mise à jour de périphérique de votre organisation restent synchronisées, vous allez devoir procéder à la même opération sur tous les serveurs hébergeant ces règles. Si vous supprimez par exemple une règle de l’un des serveurs dédiés aux services Web, vous devrez supprimer la même règles de tous vos autres serveurs de services Web. Sans quoi, vos règles de mise à jour de périphérique ne seront plus synchronisées.
Les règles de mise à jour peuvent uniquement être importées vers des services ; elles ne s’appliquent pas dans les étendues globale, Site ou Utilisateur. Veuillez néanmoins noter que Import-CsDeviceUpdate n’ajoute pas automatiquement des règles et des mises à jour à chaque service sur un site ; au lieu de cela, il charge ces règles et mises à jour uniquement pour un service en particulier. Si vous avez par exemple trois serveurs sur un site dédiés aux services Web, vous devrez exécuter Import-CsDeviceUpdate trois fois, une fois pour chaque instance des services Web. Vous pouvez également utiliser une commande comme celle montrée dans l’exemple 3 ; Cette commande récupère l’identité de tous vos serveurs services Web, puis exécute Import-CsDeviceUpdate sur chacun de ces serveurs.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Import-CsDeviceUpdate : 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 "Import-CsDeviceUpdate"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Indique l’instance du service dans laquelle les nouvelles règles de mise à jour seront appliquées. Par exemple : -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
FileName |
Facultatif |
Chaîne |
Chemin d’accès au fichier de mise à jour (par exemple, C:\Updates\UCUpdates.cab). |
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
Aucun. Import-CsDeviceUpdate n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
La cmdlet Import-CsDeviceUpdate importe les instances de la classe Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule.
Exemple
-------------------------- Exemple 1 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName C:\Updates\UCUpdates.cab
La commande montrée dans l’exemple 1 importe les règles de mise à jour de périphérique à partir du fichier C:\Updates\UCUpdates.cab.
-------------------------- Exemple 2 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName \\atl-fs-001\Updates\UCUpdates.cab
La commande montrée dans l’exemple 2 importe les règles de mise à jour de périphérique à partir du chemin d’accès UNC \\atl-fs-001\Updates\UCUpdates.cab.
-------------------------- Exemple 3 ------------------------
Get-CsService -WebServer | ForEach-Object {Import-CsDeviceUpdate -Identity $_.Identity -FileName C:\Updates\UCUpdates.cab}
L’exemple 3 indique comment vous pouvez utiliser une seule commande pour importer les règles de mise à jour des périphériques vers tous vos serveurs de services Web. Pour cela, la commande appelle d’abord Get-CsService avec le paramètre WebServer afin de retourner une collection de tous les serveurs exécutant les services Web. Cette collection est alors redirigée vers la cmdlet ForEach-Object, qui analyse chaque serveur de la collection et utilise Import-CsDeviceUpdate pour mettre à jour les règles de mise à jour des périphériques sur ces serveurs. Veuillez noter que toutes cette commande ne fonctionnera que si vous avez copié UCUpdates.cab au même endroit sur tous vos serveurs (C:\Updates).