Partager via

  • Article

Set-CsUCPhoneConfiguration

 

Dernière rubrique modifiée : 2012-03-26

Permet de modifier les options de gestion de Microsoft Lync 2010 Phone Edition. Ces dernières incluent le mode de sécurité désiré et la possibilité de verrouiller le téléphone automatiquement après une période d’inactivité donnée.

Syntaxe

Set-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]

Set-CsUCPhoneConfiguration [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-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 2010.

Les cmdlets CsUCPhoneConfiguration vous permettent d’exploiter des paramètres de configuration pour gérer des téléphones équipés de Lync 2010 Phone Edition. 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. Quand vous installez Lync Server, un seul jeu de paramètres de configuration de téléphone UC est créé et appliqué à l’étendue globale. Cependant, après l’installation, vous pouvez à tout moment utiliser la cmdlet New-CsUCPhoneConfiguration pour créer une collection de paramètres qui seront appliqués 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.

En plus de créer d’autres collections de paramètres de téléphonie pour les communications unifiées, vous pouvez également utiliser la cmdlet Set-CsUCPhoneConfiguration pour modifier les valeurs des propriétés d’une collection existante. Par exemple, la journalisation est désactivée par défaut pour les téléphones UC. Pour activer la journalisation au niveau de l’étendue globale, utilisez la cmdlet Set-CsUCPhoneConfiguration pour modifier la valeur de la propriété LoggingLevel de la collection globale sur True.

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-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 "Set-CsUCPhoneConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique à affecter à la collection de paramètres de configuration de téléphonie pour les communications unifiées. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour vous référer à une collection configurée au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité.

Si ce paramètre est omis, Set-CsUCPhoneConfiguration modifie les paramètres globaux.

Instance

Facultatif

Objet UcPhoneSettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

CalendarPollInterval

Facultatif

TimeSpan

Indique la fréquence à laquelle le périphérique UC récupère les informations dans votre calendrier Microsoft Outlook. La valeur doit être spécifiée à l’aide du format horaire heures:minutes:secondes. Par exemple, pour définir l’intervalle à 1 heure (l’intervalle maximum permis), utilisez cette syntaxe : -CalendarPollInterval "01:00:00". La valeur par défaut est de 3 minutes (00:03:00).

EnforcePhoneLock

Facultatif

Booléen

Détermine si oui ou non les téléphones seront automatiquement verrouillés après le nombre de minutes spécifié par PhoneLockTimeout. La valeur par défaut est True.

LoggingLevel

Facultatif

Chaîne

Active la journalisation sur le périphérique UC. Les valeurs valides sont Off, Low, Medium et High (Désactivé, Bas, Moyen, Élevé). La valeur par défaut est Off.

MinPhonePinLength

Facultatif

Octet

Spécifie le nombre minimal de chiffres requis pour les codes confidentiels (PIN).

Valeur minimale : 4

Valeur maximale : 15

Valeur par défaut : 6

PhoneLockTimeout

Facultatif

TimeSpan

Spécifie la durée en minutes pendant laquelle un téléphone UC peut rester inactif avant un verrouillage automatique.

Cette valeur doit être inférieure à 01:00:00 (1 heure). La valeur par défaut est 00:10:00 (10 minutes).

SIPSecurityMode

Facultatif

SIPSecurityMode

Spécifie le niveau de sécurité que le serveur appliquera aux sessions SIP initiées avec un téléphone UC.

Les valeurs valides sont les suivantes :

Low (permet tout type d’autorisation ou de transport).

Medium (NTLM ou Kerberos requis pour l’authentification utilisateur).

High (NTLM ou Kerberos sont nécessaires pour l’authentification utilisateur et TLS est requis pour les connexions SIP).

La valeur par défaut est High.

Voice8021p

Facultatif

Octet

Spécifie la valeur de priorité par utilisateur (la valeur 802.1p) pour le trafic vocal dans le déploiement de Lync Server.

Ce paramètre est effectif uniquement pour les réseaux dans lesquels les commutateurs et les ponts respectent la norme 802.1p. La valeur minimale pour cette propriété est 0 et la valeur maximale est 7. La valeur par défaut est 0.

VoiceDiffServTag

Facultatif

Octet

Spécifie la représentation décimale du marquage de priorité DSCP (DiffServ Code Point) 6 bits. Celui-ci définit le comportement par tronçon (PHB, Per Hop Behavior) des paquets IP transmis par les téléphones UC qui sont gérés par ce serveur.

Cette valeur doit être comprise entre 0 et 63, inclus. La valeur par défaut est 40.

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. Set-CsUCPhoneConfiguration accepte les instances transmises via le pipeline de l’objet des paramètres de téléphonie UC.

Types de retours

Set-CsUCPhoneConfiguration ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Exemple

-------------------------- Exemple 1 --------------------------

Set-CsUCPhoneConfiguration -Identity global -SIPSecurityMode "Medium"

La commande présentée dans l’exemple 1 définit le mode de sécurité SIP des paramètres de téléphonie UC globaux sur Medium.

-------------------------- Exemple 2 --------------------------

Set-CsUCPhoneConfiguration -Identity site:Redmond -PhoneLockTimeout "00:30:00"

La commande ci-dessus modifie les paramètres de téléphonie UC configurés pour le site de Redmond. Dans ce cas, la propriété PhoneLockTimeout est définie sur 30 ; pour cela, le paramètre -PhoneLockTimeout doit être inclus avec la valeur « 00:30:00 » (00 heure: 30 minutes: 00 seconde).

-------------------------- Exemple 3 --------------------------

Get-CsUCPhoneConfiguration -Filter "site:*" | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:30:00"

L’exemple 3 est une variante de la commande présentée dans l’exemple 2. Cependant, dans ce cas, la propriété PhoneLockTimeout est modifiée pour tous les paramètres de téléphonie UC configurés au niveau de l’étendue Site. Pour ce faire, la commande appelle la cmdlet Get-CsUCPhoneConfiguration ; le paramètre Filter et la valeur de filtre "site:*" limitent les données retournées aux paramètres de téléphonie configurés au niveau de l’étendue Site. Cette collection filtrée est ensuite redirigée vers la cmdlet Set-CsUCPhoneConfiguration qui utilise le paramètre PhoneLockTimeout avec la valeur « 00:30:00 » (00 heure: 30 minutes: 00 seconde) pour définir la valeur du paramètre PhoneLockTimeout pour chaque élément de la collection sur 30 minutes.

-------------------------- Exemple 4 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Set-CsUCPhoneConfiguration -EnforcePhoneLock $True -PhoneLockTimeout "00:30:00"

La commande ci-dessus configure les propriétés EnforcePhoneLock et PhoneLockTimeout pour tous les paramètres de téléphonie UC pour lesquels le mode de sécurité SIP est défini sur Low ou Medium. Pour effectuer cette tâche, la commande utilise d’abord la cmdlet Get-CsUCPhoneConfiguration pour retourner tous les paramètres de configuration de la téléphonie UC dans l’organisation ; ces informations sont ensuite redirigées vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la propriété SIPSecurityMode n’est pas égale à High. (Du fait que la sécurité SIP peut uniquement être définie sur Low, Medium ou High, cette clause sélectionne tous les paramètres pour lesquels SIPSecurityMode est défini soit sur Low, soit sur Medium.) La collection filtrée est ensuite redirigée vers la cmdlet Set-CsUCPhoneConfiguration qui utilise les paramètres EnforcePhoneLock et PhoneLockTimeout afin de modifier les propriétés de verrouillage et de délai de verrouillage des téléphones.

-------------------------- Exemple 5 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.PhoneLockTimeout -lt "00:10:00"} | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:10:00"

Dans l’exemple 5, la valeur de verrouillage des téléphones est définie sur 10 minutes pour tous les paramètres de téléphonie UC dont la propriété PhoneLockTimeout indique une valeur inférieure à 10 minutes. Ainsi, la valeur 10 minutes correspondra au délai de verrouillage appliqué pour dans l’ensemble de l’organisation. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsUCPhoneConfiguration pour retourner une collection de tous les paramètres de téléphonie UC actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers Where-Object qui sélectionne uniquement les paramètres dont la propriété PhoneLockTimeout indique une valeur inférieure à 10 minutes (00 heures: 10 minutes: 00 seconde). Enfin, cette collection filtrée est redirigée vers la cmdlet Set-CsUCPhoneConfiguration qui définit sur 10 minutes la valeur de la propriété PhoneLockTimeout pour chaque élément dans la collection.