New-CsUCPhoneConfiguration
Dernière rubrique modifiée : 2012-03-26
Créer une nouvelle collection des paramètres utilisés pour gérer Microsoft Lync 2010 Phone Edition. Ces paramètres vous permettent de configurer par exemple le mode de sécurité et de spécifier si le téléphone doit être automatiquement verrouillé ou pas après une période d’activité spécifiée.
Syntaxe
New-CsUCPhoneConfiguration -Identity <XdsIdentity> [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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.
Lync Server 2010 inclut plusieurs cmdlets qui vous permettent de gérer vos téléphones exécutant Lync 2010. Par exemple, vous pouvez contrôler certains aspects, tels que la longueur minimale du code confidentiel (PIN) 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). 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.
New-CsUCPhoneConfiguration permet de créer des paramètres de téléphone UC au niveau de l’étendue Site. Remarque : il ne peut y avoir qu’une seule collection de paramètres par site. Par exemple, supposons que vous essayiez de créer une collection de paramètres ayant l’identité site:Redmond, mais qu'un jeu de paramètres téléphoniques UC ait déjà été assigné au site Redmond. Dans ce cas, votre commande échouera. Vous devez plutôt effectuer l’une des deux opérations suivantes : soit supprimer les paramètres existants et ensuite utiliser New-CsUCPhoneConfiguration pour créer une nouvelle collection de paramètres ou utiliser simplement Set-CsUCPhoneConfiguration pour modifier les paramètres existants.
Vous ne pouvez pas créer de collections de paramètres au niveau de l'étendue globale. La seule chose à faire au niveau de l’étendue globale est d’utiliser Set-CsUCPhoneConfiguration pour modifier les paramètres existants.
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-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 "New-CsUCPhoneConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Représente l’identificateur unique à assigner à la nouvelle collection de paramètres de configuration du téléphone UC. Puisque vous ne pouvez créer des collections qu’au niveau de l’étendue Site, l’identité sera toujours le préfixe « site: » suivi du nom du site, par exemple « site:Redmond ». |
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 2010. 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. |
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-CsUCPhoneConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsUCPhoneConfiguration -Identity site:Redmond -CalendarPollInterval "00:10:00" -LoggingLevel "Medium"
La commande précédente crée une nouvelle collection de paramètres de configuration UC pour le site Redmond. Dans cet exemple, deux paramètres facultatifs sont inclus ainsi que le paramètre requis Identity : CalendarPollInterval, qui définit le temps d’interrogation du calendrier sur 10 minutes (00 heures: 10 minutes: 00 seconde), et LoggingLevel, qui configure le niveau de téléphone UC sur Medium. Une fois cette commande achevée, les nouveaux paramètres seront appliqués au site Redmond et le téléphone UC des utilisateurs de ce site sera régi par les nouveaux paramètres. Notez que cette commande échouera si le site Redmond a déjà une collection de paramètres de téléphone UC.
-------------------------- Exemple 2 --------------------------
$x = New-CsUCPhoneConfiguration -Identity site:Redmond -InMemory
$x.CalendarPollInterval = "00:10:00"
$x.LoggingLevel = "Medium"
Set-CsUCPhoneConfiguration -Instance $x
L’exemple 2 montre comment utiliser le paramètre InMemory. Ce paramètre permet de créer un nouveau jeu de paramètres pour le téléphone UC existant qui seront mis en mémoire uniquement. (Ces paramètres sont enregistrés dans la variable $x.). Une fois la collection virtuelle créée, vous pouvez modifier les paramètres « en mémoire uniquement » à l’aide des commandes qui ressemblent aux lignes 2 et 3 de l’exemple : à la ligne 2, la propriété CalendarPollInterval est fixée à 10 minutes (00 heure: 10 minutes: 00 seconde), et à la ligne 3, la propriété LoggingLevel a la valeur Medium.
Une fois la modification de ces valeurs de propriété effectuée, vous pouvez utiliser Set-CsUCPhoneConfiguration pour transformer les paramètres virtuels stockés dans $x en collection effective de paramètres appliqués au site de Redmond. Notez qu’avec le paramètre InMemory, les paramètres ne sont pas effectivement appliqués tant que vous n’appelez pas Set-CsUCPhoneConfiguration. Si vous n’appelez pas cette cmdlet, vos paramètres virtuels disparaîtront une fois votre session Windows PowerShell terminée ou quand vous aurez supprimé la variable $x.
Voir aussi
Autres ressources
Get-CsUCPhoneConfiguration
Remove-CsUCPhoneConfiguration
Set-CsUCPhoneConfiguration