Partager via

  • Article

Set-CsCommonAreaPhone

 

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

Modifie les valeurs de propriété d'un téléphone en zone commune géré par Microsoft Lync Server 2010. Les téléphones en zone commune sont des téléphones situés dans les halls d’accueil des immeubles, les espaces réservés aux employés ou d’autres zones où ils sont susceptibles de servir à plusieurs personnes et pour des usages différents.

Syntaxe

Set-CsCommonAreaPhone -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les téléphones en zone commune sont des téléphones IP qui ne sont pas associés à un utilisateur individuel. Ils ne sont pas confinés au bureau d’une seule et unique personne mais généralement installés dans des halls d’accueil, des cafétérias, des espaces réservés aux employés, des salles de réunion et d’autres lieux où plusieurs personnes peuvent se rassembler et se retrouver. Pour les administrateurs, cette situation pose un défi en matière de gestion ; ceci parce que l’usage d’un téléphone dans Lync Server 2010 est généralement soumis à des stratégies de voix et des plans de numérotation qui sont attribués à des utilisateurs individuels. Aucun utilisateur individuel n’est affecté aux téléphones en zone commune.

Une solution à ce défi consiste à créer des objets contact Active Directory pour l’ensemble de vos téléphones en zone commune. (Ces objets contact peuvent être créés à l’aide de la cmdlet New-CsCommonAreaPhone. À l’instar des comptes d’utilisateurs, des stratégies et des plans de numérotation peuvent être attribués à des objets contact. Vous pourrez par conséquent garder le contrôle de vos téléphones en zone commune même s’ils ne sont pas associés à un utilisateur individuel. Par exemple, si vous ne souhaitez pas que des gens puissent transférer ou mettre en garde des appels à partir d’un téléphone en zone commune, vous pouvez créer une stratégie de voix pour empêcher tout transfert ou parcage des appels, puis attribuer cette stratégie au téléphone en zone commune. (Ou, plus précisément, à l’objet contact qui représente ce dernier.) Cette commande attribue la stratégie de voix CommonAreaPhoneVoicePolicy à tous vos téléphones en zone commune :

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

La cmdlet Set-CsCommonAreaPhone vous offre la possibilité de modifier les propriétés des objets contact associés à des téléphones en zone commune. Vous pouvez notamment modifier le nom complet Active Directory du contact ou l’URI (Uniform Resource Identifier) de ligne associée au téléphone. Vous pouvez aussi vous servir du paramètre Enabled pour activer et désactiver le compte utilisé dans Lync Server 2010.

En outre, vous pouvez configurer la fonctionnalité téléphone « rouge » pour les téléphones de partie commune à l’aide des cmdlets CsClientPolicy. Lorsqu’un téléphone sert de téléphone « rouge », les utilisateurs peuvent se connecter à ce téléphone à l’aide de leurs informations d’identification Lync Server. Cela permet notamment aux utilisateurs d’accéder facilement à leurs contacts. Pour plus d’informations, consultez la rubrique d’aide relative à la cmdlet Set-CsClientPolicy.

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-CsCommonAreaPhone : RTCUniversalUserAdmins. Les autorisations d’exécuter cette cmdlet pour des sites spécifiques ou des unités d’organisation Active Directory spécifiques peuvent être attribuées au moyen de la cmdlet Grant-CsOUPermission. 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-CsCommonAreaPhone"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

Identificateur unique du téléphone en zone commune. Les téléphones en zone commune sont identifiés à l’aide du nom unique Active Directory de l’objet contact associé. Ils utilisent par défaut un identificateur global unique (GUID) comme nom commun et affichent donc généralement une valeur Identity (identité) semblable à la suivante : CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Pour cette raison, il vous paraîtra peut-être plus simple d’extraire des téléphones en zone commune à l’aide de la cmdlet Get-CsCommonAreaPhone, puis en redirigeant les objets retournés vers Set-CsCommonAreaPhone.

Enabled

Facultatif

Chaîne

Indique si l’objet contact du téléphone en zone commune a été activé ou non pour Lync Server 2010.

Si vous désactivez un contact à l’aide du paramètre Enabled, les informations associées à ce compte (notamment les stratégies attribuées et l’activation/désactivation du contact pour Enterprise Voice, le contrôle d’appels distants et/ou l’intégration de la messagerie vocale) sont conservées. Si, par la suite, vous réactivez le compte en utilisant le paramètre Enabled, les informations associées à ce compte seront restaurées.

Description

Facultatif

Chaîne

Permet de modifier un attribut de description Active Directory pour le téléphone en zone commune. Cette option offre un moyen de fournir des informations supplémentaires concernant le téléphone. Par exemple, vous pouvez apporter des détails sur la personne à contacter en cas de problèmes avec le téléphone.

DisplayName

Facultatif

Chaîne

Permet de modifier le nom complet Active Directory du téléphone en zone commune.

DisplayNumber

Facultatif

Chaîne

Numéro de téléphone tel qu’il est affiché dans Microsoft Lync 2010. La propriété DisplayNumber peut prendre le format que vous souhaitez, par exemple 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234, et ainsi de suite. Lors du choix d'un numéro complet, n'oubliez pas que celui-ci sera affiché sur l'écran du téléphone en zone commune seulement s'il peut être normalisé. (La normalisation est le processus de traduction de chaînes de numéros en un format de numéro de téléphone standard.) S'il n'existe pas de règle de normalisation pour le format de numéro de téléphone utilisé lors de la configuration du numéro complet, l'écran du téléphone en zone commune affichera la valeur de la propriété LineUri plutôt que la valeur de la propriété DisplayNumber.

DomainController

Facultatif

Chaîne

Permet de se connecter au contrôleur de domaine spécifié afin de modifier des informations de contact. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de l’ordinateur (par exemple, atl-mcs-001) ou de son nom de domaine complet ; par exemple : atl-mcs-001.litwareinc.com.

EnterpriseVoiceEnabled

Facultatif

Booléen

Indique si l’objet contact du téléphone en zone commune a été activé pour Enterprise Voice, la solution de protocole VoIP (Voice over Internet Protocol) proposée par Microsoft. Avec Enterprise Voice, les utilisateurs peuvent passer des appels téléphoniques via Internet au lieu d’utiliser le réseau téléphonique standard.

LineUri

Facultatif

Chaîne

Numéro téléphonique du téléphone en zone commune. L’URI (Uniform Resource Identifier) de la ligne doit être précisée au format E.164 et munie du préfixe « TEL: » . Par exemple : TEL:+14255551297. Tout numéro de poste doit être ajouté à la fin de l’URI de ligne ; par exemple : TEL:+14255551297; ext=51297.

SipAddress

Facultatif

Adresse SIP

Identificateur unique permettant au téléphone en zone commune de communiquer avec des périphériques SIP, tels que Lync 2010. L’adresse SIP doit être précédée du préfixe sip: et inclure un domaine SIP valide. Par exemple : sip:bldg14lobby@litwareinc.com.

PassThru

Facultatif

Paramètre de commutateur

Retourne un objet représentant le téléphone en zone commune.

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.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Types de retours

Par défaut, Set-CsCommonAreaPhone ne retourne ni objet, ni valeur. Toutefois, si vous incluez le paramètre PassThru, la cmdlet retourne des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Exemple

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

Get-CsCommonAreaPhone -Filter {LineUri -eq "tel:+14255556710"} | Set-CsCommonAreaPhone -DisplayName "Employee Lounge"

L’exemple 1 modifie le nom complet Active Directory du téléphone en zone commune dont le numéro est 1-425-555-6710. Pour ce faire, Get-CsCommonAreaPhone est d’abord appelée avec le paramètre Filter ; la valeur de filtre {LineUri -eq "tel:+14255556710"} limite les données retournées au téléphone en zone commune dont la propriété LineUri est égale à +14255556710. L’objet retourné est ensuite redirigé vers Set-CsCommonAreaPhone qui définit la valeur de la propriété DisplayName sur « Employee Lounge ».

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

Get-CsCommonAreaPhone | Set-CsCommonAreaPhone -Enabled $True

La commande illustrée dans l’exemple 2 active tous les téléphones en zone commune actuellement configurés dans l’organisation. Pour effectuer cette tâche, la commande appelle Get-CsCommonAreaPhone sans aucun paramètre afin de retourner une collection contenant tous les téléphones en zone commune. Cette collection est ensuite redirigée vers la cmdlet Set-CsCommonAreaPhone qui prend chaque élément dans la collection et définit la propriété Enabled sur True.

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

Get-CsCommonAreaPhone -Filter {Description -eq $Null} | Set-CsCommonAreaPhone -Description "Common area phone"

La commande ci-dessus ajoute une description générique à tous les téléphones en zone commune pour lesquels aucune valeur n’est attribuée à la propriété Description. Pour ce faire, Get-CsCommonAreaPhone est d’abord appelée avec le paramètre Filter ; la valeur de filtre {Description -eq $Null} garantit que les seuls éléments retournés correspondent à des téléphones en zone commune dont la propriété Description est égale à une valeur null. Cette collection filtrée est ensuite redirigée vers Set-CsCommonAreaPhone qui attribue la description générique « Common area phone » (téléphone en zone commune) à chaque élément au sein de la collection.