Script Action: Edit mail user (Exchange 2007)

Function

Edit the attributes of a mail enabled user by specifying the properties.

Deployment

This action is typically used for editing the settings of mail users. Previous values of the properties listed below will be overwritten. Use $null to clear properties.

Properties

Property Name Description Typical setting Remarks

Identity The Identity parameter identifies

the mail enabled user. (CN=jsmith,OU=sales,DC=tools4ever,DC=com), tools4ever.com\Jsmith, JSmith, [email protected] or the GUID.

Accept messages

only from Optional value. The 'Accept messages only from' parameter specifies the mailbox users, mail users and mail contacts that can send e-mail messages to this mailbox. Use commas to specify multiple values.

(CN=jsmith,OU=sales,DC=tools4ever,DC=com), tools4ever.com\Jsmith, JohnSmith, JSmith, John Smith, [email protected] or the GUID.

Alias Optional value. The Alias parameter specifies the alias of the mail enabled user. The alias can be a combination of

characters separated by a period with no intervening spaces. Do not use special characters in the alias.

JSmith

Custom attribute

1 Optional value. The 'Custom attribute 1' parameter specifies the value for the mailbox attribute CustomAttribute1.

Custom attribute

2 Optional value. The 'Custom attribute 2' parameter specifies the value for the mailbox attribute CustomAttribute2.

Custom attribute

3 Optional value. The 'Custom attribute 3' parameter specifies the value for the mailbox attribute CustomAttribute2.

145

Custom attribute

4 Optional value. The 'Custom attribute 4' parameter specifies the value for the mailbox attribute CustomAttribute2.

Custom attribute

5 Optional value. The 'Custom attribute 5' parameter specifies the value for the mailbox attribute CustomAttribute2.

Display name The 'Display name' parameter specifies the display name of the user.

John Smith

Domain controller Optional value. The name of the domain controller used to write this configuration change to Active Directory. Use the fully qualified domain name (FQDN) of the domain controller.

EXCHSERVER.tools4ever.com..

Email addresses The 'Email addresses' parameter can be used to specify the e-mail alias of the mail user. All valid Microsoft Exchange 2007 e-mail address types may be used. Use commas to specify multiple values.

SMTP:[email protected], smtp:[email protected]

Emailaddress

policy enabled The 'Emailaddress policy enabled' parameter specifies whether the e-mail address policy for this mailbox is enabled.

'Yes' or 'No'

External email

address The 'External email address' parameter specifies whether the e-mail addresses for the mailbox will be automatically updated based on the e-mail address policies defined. When this parameter is set to 'Yes', the 'Primary SMTP address' or 'Windows email address' parameters cannot be changed.

smtp:[email protected]

Grant send on

behalf to The 'Grant send on behalf to' parameter specifies the distinguished name (DN) of recipients that can send messages on behalf of this user.

CN=jsmith,OU=sales,DC=tools4ever,DC=com

Hidden from address lists enabled

The 'Hidden from address lists enabled' parameter specifies whether the user appears in the address lists.

146

Maximum receive

size The 'Maximum receive size' parameter specifies the maximum size of e-mail messages that can be received by the mail user, from 1 kilobyte (KB) to 2,097,151 KB. If not specified, there will be no size restrictions. Qualify the value with one of the following: B (bytes), KB (kilobytes), MB (megabytes), GB (gigabytes) or "unlimited".

50MB

Maximum send

size The 'Maximum send size' parameter specifies the maximum size of e-mail messages that can be sent by the mail user, from 1 KB to 2,097,151 KB. If not specified, there will be no size restrictions. Qualify the value with one of the following: B (bytes), KB (kilobytes), MB (megabytes), GB (gigabytes) or "unlimited".

50MB

Name The 'Name' parameter specifies

the name of the user. John Smith Primary SMTP

address The 'Primary SMTP address' parameter specifies the address that external users will see when they receive a message from this mailbox. If this parameter is used, the 'Email addresses' parameter cannot be used because 'Email addresses' includes the primary SMTP address.

SMTP:[email protected]

Recipient limits The 'Recipient limits' parameter specifies the maximum number of recipients for messages from this user. Specify either an integer or "unlimited." If this attribute is set on a mailbox, it overrides the default value that is set for this attribute on the hub transport server.

unlimited

Reject messages

from The 'Reject messages from' parameter specifies the recipients from whom messages will be rejected. Use commas to specify multiple values.

domain.com/Sales/JSmith

Require sender authentication enabled

The 'Require sender

authentication enabled' parameter specifies whether senders must be authenticated.

147

SamAccountName The 'SamAccountName' parameter defines the logon name used to support clients and servers running older versions of the operating system, such as Microsoft Windows NT 4.0, Windows 98, Windows 95, and LAN Manager. This parameter must be less than 20 characters in length.

jsmith

Simple display

name The 'Simple display name' parameter is used on objects where the name of the object may be displayed in an environment that does not support Unicode characters. The only supported characters for the

SimpleDisplayName parameter are ASCII characters 26 through 126, inclusively. These characters are the ones that are typically found on most U.S. English keyboards.

John Smith

User principal

name The 'User principal name' parameter specifies the user principal name (UPN) for the mail user.

[email protected]

Windows

emailaddress The 'Windows emailaddress' parameter specifies the Windows e-mail address for this mail user. This address is not used by Exchange.

148