add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Parameters

Common area phones are IP telephones that are not associated with an individual user; instead of being located in someone’s office, common area phones are typically located in building lobbies, cafeterias, employee lounges, meeting rooms and other locations where a large number of people are likely to congregate (and might need to use the phone). This presents administrators with a management challenge. After all, phone use in Microsoft Communications Server is typically maintained by using various voice policies and dial plans, policies and plans that are assigned to individual users. How can you manage a device that isn’t associated with an individual user?

One solution is to create Active Directory contact objects for all your common area phones. (These contact objects can be created using the New-CsCommonAreaPhone cmdlet.) Like user accounts, these contact objects can be assigned policies and voice plans. As a result, you will be able to maintain control over common area phones even though those phones are not associated with an individual user. For example, if you do not want people to have the ability to transfer or park calls from a common area phone, all you have to do is create a voice policy that prohibits call transfers and call parking, then assign that policy to the common area phone. (Or, more correctly, to the contact object that represents the common area phone.) For example, this command assigns the voice policy CommonAreaPhoneVoicePolicy to all your common area phones:

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

The Set-CsCommonAreaPhone cmdlet provides a way for you to modify the properties of the contact objects associated with common area phones. Among other things, you can change the contact’s Active Directory display name and well as the line URI associated with the phone. You can also use the –CsEnabled parameter to enable and disable the account for use with Microsoft Communications Server.

Set-CsCommonAreaPhone does not return any objects or values. Instead, the cmdlet modifies existing instances of the Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact object.

-------------------------- Example 1 ------------------------

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

Example 1 modifies the Active Directory display name for the common area phone with the phone number 1-425-555-6710. To do this, Get-CsCommonAreaPhone is first called, along with the –Filter parameter; the filter value {LineUri -eq "tel:+14255556710"} limits the returned data to the common area phone where the LineUri property is equal to (-eq) tel:+14255556710. The returned object is then piped to Set-CsCommonAreaPhone, which sets the value of the DisplayName property to "Employee Lounge".

-------------------------- Example 2 ------------------------

	Copy Code
Get-CsCommonAreaPhone | Set-CsCommonAreaPhone -CsEnabled $True

The command shown in Example 2 enables all the common area phones currently configured use in the organization. To carry out this task, the command calls Get-CsCommonAreaPhone without any parameters in order to return a collection of all the common area phones. This collection is then piped to the Set-CsCommonAreaPhone cmdlet, which takes each item in the collection and sets the CsEnabled property to True ($True).

-------------------------- Example 3 ------------------------

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

The preceding command adds a generic description to all the common area phones that do not have a value assigned to the Description property. To do this, Get-CsCommonAreaPhone is called along with the –Filter parameter; the filter value {Description -eq $Null} ensures that the only items returned are common area phones where the Description property is equal to (-eq) a null value ($Null). This filtered collection is then piped to Set-CsCommonAreaPhone, which assigns the generic description "Common area phone" to each item in the collection.