Remove-CsUCPhoneConfiguration
Dernière rubrique modifiée : 2012-03-26
Supprime l’ensemble de paramètres de configuration Microsoft Lync 2010 Phone Edition spécifié. Ces paramètres déterminent, entre autres, le mode de sécurité désiré et le verrouillage automatique (ou non) du téléphone après une période d’inactivité donnée.
Syntaxe
Remove-CsUCPhoneConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Lync 2010 Phone Edition représente la fusion du téléphone et de Microsoft Lync 2010. Lync 2010 Phone Edition utilise un matériel spécial (c’est-à-dire un téléphone compatible avec Lync 2010) capable de fonctionner en mode VoIP (Voice over Internet Protocol). De plus, ce matériel peut également servir de système d’extrémité de type Lync 2010 : vous pouvez définir votre statut actuel, vérifier le statut de vos contacts Lync 2010, rechercher de nouveaux contacts et réaliser de nombreuses autres opérations habituellement effectuées dans Lync.
Microsoft Lync Server 2010 inclut plusieurs cmdlets qui vous permettent de gérer vos téléphones Lync 2010. Par exemple, vous pouvez contrôler certains aspects, tels que la longueur minimale du code confidentiel utilisé pour vous connecter au téléphone et déterminer si le téléphone doit ou non se verrouiller automatiquement après une période d’inactivité donnée.
Vous pouvez appliquer des paramètres de configuration téléphonique pour les communications unifiées (UC) au niveau de l’étendue globale ou au niveau de l’étendue Site. (Les paramètres appliqués au niveau de l’étendue Site ont priorité sur les paramètres configurés au niveau de l’étendue globale). Lorsque vous installez Lync Server 2010, un ensemble de paramètres de configuration de la téléphonie UC est créé et appliqué au niveau de l’étendue globale. Toutefois, vous pouvez ensuite à tout moment utiliser la cmdlet New-CsUCPhoneConfiguration cmdlet pour créer un ensemble de paramètres appliqué au niveau de l’étendue Site. Cela vous permet d’adapter la gestion des téléphones pour les communications unifiées (UC) aux besoins uniques de chaque site.
Vous pouvez supprimer ultérieurement les paramètres créés via New-CsUCPhoneConfiguration à l’aide de la cmdlet Remove-CsUCPhoneConfiguration. Lorsque vous supprimez les paramètres d’un site, les téléphones Lync 2010 de ce site ne sont pas délaissés. En effet, ces derniers sont automatiquement placés sous le contrôle des paramètres globaux.
Vous pouvez également exécuter Remove-CsUCPhoneConfiguration sur les paramètres globaux. Cependant, si vous choisissez d’effectuer cette action, les paramètres globaux ne seront pas supprimés : vous ne pouvez pas supprimer les paramètres globaux de téléphonie UC. Au lieu de cela, les valeurs par défaut des propriétés des paramètres globaux seront rétablies. Par exemple, si vous avez modifié l’intervalle de verrouillage du téléphone à 30 minutes, la « suppression » des paramètres globaux entraînera la réinitialisation de l’intervalle à la valeur par défaut de 10 minutes.
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-CsUCPhoneConfiguration : 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-CsUCPhoneConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique de l’ensemble de paramètres de configuration de téléphonie UC à supprimer. Pour supprimer un ensemble de sites, utilisez la syntaxe suivante : -Identity "site:Redmond". Pour supprimer (réinitialiser) la collection globale, utilisez la syntaxe suivante : -Identity global. Notez que les caractères génériques ne sont pas autorisés lors de la spécification d’une identité de stratégie. |
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.Policy.Voice.UcPhoneSettings. Remove-CsUCPhoneConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres de la téléphonie UC.
Types de retours
Aucun. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.
Exemple
-------------------------- Exemple 1 ------------------------
Remove-CsUCPhoneConfiguration -Identity site:Redmond
La commande illustrée dans l’exemple 1 supprime les paramètres de configuration de téléphonie UC du site de Redmond (-Identity site:Redmond). Lorsque les paramètres sont supprimés d’une étendue Site, les téléphones UC des utilisateurs de ce site sont régis par les paramètres globaux de configuration des téléphones.
-------------------------- Exemple 2 ------------------------
Get-CsUCPhoneConfiguration -Filter site:* | Remove-CsUCPhoneConfiguration
Dans l’exemple 2, tous les paramètres de téléphonie UC ayant été configurés dans l’étendue Site sont supprimés. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsUCPhoneConfiguration et le paramètre Filter pour renvoyer tous les paramètres configurés dans l’étendue Site. La valeur de filtre « site:* » limite les données renvoyées aux paramètres dont la propriété Identity (la seule sur laquelle le filtrage peut être basé) commence par la valeur de chaîne « site: ». La collection filtrée est ensuite acheminée vers Remove-CsUCPhoneConfiguration, qui supprime chaque élément dans la collection.
-------------------------- Exemple 3 ------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False} | Remove-CsUCPhoneConfiguration
Dans l’exemple 3, tous les paramètres de téléphonie UC qui n’appliquent pas le verrouillage de téléphone sont supprimés. Pour exécuter cette tâche, la commande utilise d’abord la cmdlet Get-CsUCPhoneConfiguration sans aucun paramètre pour renvoyer un ensemble de tous les paramètres de téléphonie UC actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui choisit uniquement les paramètres pour lesquels la propriété EnforceLockProperty est égale à False. L’ensemble filtré est alors redirigé vers la cmdlet Remove-CsUCPhoneConfiguration, qui supprime chaque élément contenu dans l’ensemble.
-------------------------- Exemple 4 ------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Remove-CsUCPhoneConfiguration
La commande précédente supprime tous les paramètres de configuration de téléphonie UC pour lesquels le mode de sécurité SIP est défini sur Low ou Medium. Pour cela, la cmdlet Get-CsUCPhoneConfiguration est d’abord appelée pour renvoyer un ensemble de tous les paramètres de téléphonie UC configurés pour être utilisés dans l’organisation. Cet ensemble est ensuite redirigé vers Where-Object, qui sélectionne uniquement les paramètres dont la propriété SIPSecurityMode est définie sur Low ou Medium. Cette opération est effectuée en sélectionnant les paramètres dont la propriété SIPSecurityMode est différente de High (il existe trois valeurs possibles pour SIPSecurityMode : Low, Medium et High). L’ensemble filtré est ensuite redirigé vers la cmdlet Remove-CsUCPhoneConfiguration, qui supprime tous les paramètres dont la propriété SIPSecurityMode est différente de High.
Voir aussi
Autres ressources
Get-CsUCPhoneConfiguration
New-CsUCPhoneConfiguration
Set-CsUCPhoneConfiguration