Partager via


Get-CsCommonAreaPhone

 

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

Retourne des informations sur les téléphones en zone commune gérés 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

Get-CsCommonAreaPhone [-Identity <UserIdParameter>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-DomainController <Fqdn>] [-Credential <PSCredential>] [-ResultSize <Unlimited`1>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

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.

La 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). Par exemple, cette commande attribue la stratégie de voix CommonAreaPhoneVoicePolicy à tous vos téléphones en zone commune :

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

Get-CsCommonAreaPhone permet de récupérer des informations sur les téléphones en zone commune configurés pour être utilisés au sein de votre organisation. Si vous appelez Get-CsCommonAreaPhone sans aucun paramètre, la cmdlet retournera des informations sur tous vos téléphones en zone commune. Des paramètres facultatifs offrent différents moyens de filtrer les informations ; par exemple, vous pouvez retourner tous les téléphones en zone commune qui ont des objets contact dans une unité d’organisation (OU) spécifiée ou tous les objets contact situés dans un bâtiment donné.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsCommonAreaPhone : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsCommonAreaPhone"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

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é. Par défaut, les téléphones en zone commune utilisent un identificateur global unique (GUID) comme nom commun et ont donc généralement un identificateur similaire à celui-ci : CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Credential

Facultatif

Objet Credential PS

Permet d’exécuter la cmdlet Get-CsCommonAreaPhone avec d’autres informations d’identification. Ceci peut être requis si le compte que vous avez utilisé pour vous connecter à Windows ne dispose pas des privilèges nécessaires pour manipuler les objets contact.

Pour utiliser le paramètre Credential, vous devez d’abord créer un objet PSCredential à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique d’aide de la cmdlet Get-Credential.

DomainController

Facultatif

Chaîne

Permet de vous connecter au contrôleur de domaine spécifié, afin de récupérer des informations de contact. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de domaine complet (FQDN) de cet ordinateur (par exemple, atl-cs-001.litwareinc.com).

Filter

Facultatif

Chaîne

Vous permet de limiter les données retournées en filtrant les attributs spécifiques de Lync Server 2010. Par exemple, vous pouvez limiter les données retournées aux objets contact de téléphone en zone commune auxquels une stratégie de voix spécifique a été attribuée ou aux contacts auxquels aucune stratégie de voix spécifique n’a été attribuée.

Le paramètre Filter utilise la même syntaxe de filtrage Windows PowerShell que celle employée par la cmdlet Where-Object.

LdapFilter

Facultatif

Chaîne

Permet de limiter les données retournées en filtrant les attributs Active Directory génériques (c’est-à-dire les attributs qui ne sont pas spécifiques à Lync Server 2010). Ainsi, vous pouvez limiter les données retournées aux objets contact attribués à un service spécifique, ou encore situés dans un bâtiment en particulier.

Le paramètre LdapFilter utilise le langage de requête LDAP lors de la création des filtres. Par exemple, un filtre qui retourne uniquement les objets contact représentant les téléphones en zone commune dans la ville de Redmond se présente comme suit :

-LDAPFilter "l=Redmond"

Dans le filtre ci-dessus, « l » (L minuscule) correspond à l’attribut Active Directory (locality, ou ville), « = » correspond à l’opérateur de comparaison (égal à) et « Redmond » correspond à la valeur de filtre.

OU

Facultatif

Nom unique Active Directory

Permet de retourner les objets contact à partir d’une unité d’organisation (OU) Active Directory spécifique. Le paramètre OU retourne les données provenant de l’unité d’organisation (OU) spécifiée et de toutes ses unités d’organisation enfants. Par exemple, si l’unité d’organisation Finance a deux unités d’organisation enfants, AccountsPayable et AccountsReceivable, les informations de téléphone en zone commune seront retournées depuis chacune de ces unités d’organisation.

Lors de la spécification d’une unité d’organisation, utilisez le nom unique de ce conteneur, par exemple : -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

Facultatif

Entier

Permet de limiter le nombre d’enregistrements retournés par une commande. Par exemple, pour retourner sept téléphones en zone commune (quel que soit le nombre de téléphones en zone commune présents dans votre forêt), incluez le paramètre ResultSize et définissez sa valeur à 7. Notez qu’il est impossible de savoir quels seront les sept téléphones en zone commune retournés. Si vous définissez ResultSize à 7, mais que votre forêt ne compte que trois téléphones en zone commune, la commande renverra ces trois téléphones et se terminera sans erreur.

La taille des résultats peut être définie sur n’importe quel entier compris entre 0 et 2147483647 (inclus). Si le paramètre est défini sur 0, la commande s’exécutera, mais aucune donnée ne sera renvoyée.

Types d’entrées

Chaîne. Get-CsCommonAreaPhone accepte une valeur de chaîne transmise par pipeline représentant l’identité du téléphone en zone commune.

Types de retours

Get-CsCommonAreaPhone retourne les instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Exemple

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

Get-CsCommonAreaPhone

La commande présentée dans l’exemple 1 retourne des informations sur tous les téléphones en zone commune configurés pour être utilisés dans l’organisation. Cette opération s’effectue en appelant Get-CsCommonAreaPhone sans aucun paramètre.

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

Get-CsCommonAreaPhone -Filter {DisplayName -eq "Building 14 Lobby"}

Dans l’exemple 2, le téléphone en zone commune dont le nom complet Active Directory est « Building 14 Lobby » (Hall, Bâtiment 14) est retourné. Cette tâche s’effectue en incluant le paramètre Filter et la valeur de filtre {DisplayName -eq "Building 14 Lobby"} ; cette valeur de filtre limite les objets retournés aux téléphones en zone commune pour lesquels la propriété DisplayName est égale à « Building 14 Lobby ».

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

Get-CsCommonAreaPhone  -Filter {DisplayName -like "Building 14*"}

La commande ci-dessus retourne tous les téléphones en zone commune dont le nom complet Active Directory commence par les caractères « Building 14 ». Pour ce faire, le système appelle Get-CsCommonAreaPhone, ainsi que le paramètre Filter et la valeur de filtre {DisplayName -like "Building 14*"}. La valeur de filtre utilise l’opérateur -like et la chaîne à caractère générique « Building 14* » pour limiter les données retournées aux téléphones dont la propriété DisplayName commence par « Building 14 » (par exemple, « Building 14 Lobby », « Building 14 Cafeteria », etc.).

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

Get-CsCommonAreaPhone  -Filter {LineUri -eq "tel:+14255551234"}

Dans l’exemple 4, un seul téléphone en zone commune est retourné : le téléphone dont la propriété LineUri est égale à « tel:+14255551234 ». Comme ces URI de ligne doivent être uniques, cette commande ne retourne jamais plusieurs éléments.

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

Get-CsCommonAreaPhone -Filter {DialPlan -eq $Null}

La commande de l’exemple 5 retourne des informations sur tous les téléphones en zone commune auxquels aucun plan de numérotation n’a été attribué. Cette tâche s’effectue en utilisant le paramètre Filter et la valeur de filtre {DialPlan -eq $Null} ; elle limite les données retournées aux téléphones dont la propriété DialPlan a une valeur Null. Si un téléphone en zone commune ne s’est pas vu explicitement attribuer un plan de numérotation, il utilise alors automatiquement le plan de numérotation global ou, le cas échéant, le plan attribué au site.

-------------------------- Exemple 6 ------------------------

Get-CsCommonAreaPhone -OU "ou=Telecommunications,dc=litwareinc,dc=com"

La commande ci-dessus retourne une collection de tous les téléphones en zone commune ayant un objet contact au sein de l’unité d’organisation Telecommunications dans services de domaine Active Directory (AD DS). Pour ce faire, le système appelle Get-CsCommonAreaPhone, ainsi que le paramètre OU ; la valeur de paramètre limite les objets retournés aux téléphones ayant des objets contact dans l’unité d’organisation dont le nom unique est ou=Telecommunications,dc=litwareinc,dc=com.