5.3. Using the EMS to Manage Mailbox Properties
The Set-User and the Get-User cmdlets helped you with non-Exchange-specific properties of a user account, but the Get-Mailbox and the Set-Mailbox
cmdlets will help you view and set the properties of a mailbox-enabled
user account.Let's
take a quick look at some ways you can use these cmdlets. For example,
if you want to change the user Cheyne.Manalo's rules quota, you would
type this:
Set-Mailbox cheyne.manalo -RulesQuota:128KB
You can set a lot of properties through the EMS and the Set-Mailbox cmdlet. A few of the more useful ones are found in Table 4.
Table 4 shows just a few of the parameters that can be used by the Set-Mailbox cmdlet or that can be viewed using the Get-Mailbox cmdlet. If you want to look up these parameters, from the EMS type Set-Mailbox -?, or type Help Set-Mailbox. As we showed you previously with Get-User, you can pipe the output for a mailbox to the Format-List (or FL) cmdlet and see all the properties for that mailbox. Following Table 4,
you will see some examples of some of the properties; we did trim out a
few of the properties to save space. You may notice that there are some
properties that you will find by issuing the Get-User cmdlet also. That is expected; remember many of these properties for both Get-User and Get-Mailbox are stored as properties on the same Active Directory user object.
Table 4. Some Set-Mailbox Properties
Parameter | Function |
---|
RulesQuota | Specifies
the maximum amount of rules a user can have in a folder. Note that
having more than 32 KB of rules per folder requires the Outlook 2007
client. |
SCLDeleteThreshold | Specifies the SCL (spam confidence level) value at and above which messages flagged as spam should be deleted. |
SCLDeleteEnabled | Specifies if messages above the value of the SCLDeleteThreshold property should be deleted. There are additional SCL threshold options that are not listed in this table. |
RecipientLimits | Specifies the maximum number of recipients per message that a user can send to. |
EmailAddressPolicy Enabled | Specifies whether or not this mailbox should have its email addresses updated by email address policies. |
MaxSendSize | Specifies the maximum size for messages that can be sent by this mailbox. |
MaxReceiveSize | Specifies the maximum size for messages that can be received into this mailbox. |
ForwardingAddress | Specifies an address to which mail sent to this mailbox will be forwarded. The value must be in canonical name format, such as volcanosurfboards.com/Corporate/Mike Brown. |
HiddenFromAddress ListsEnabled | If set to True, this mailbox will not appear in any of the Exchange address lists. The default is False. |
CustomAttribute1 | Specifies
the value for Custom Attribute 1 (Extension Attribute 1). Fifteen
custom attributes can be set through the EMS; simply change 1 to 2, 3,
and so on. |
ProhibitSendQuota | Specifies the mailbox size above which the user will not be able to send any new messages. |
ProhibitSend ReceiveQuota | Specifies the mailbox size above which the mailbox will reject new mail and the user will not be able to send any messages. |
IssueWarningQuota | Specifies the mailbox size above which users will receive a warning message indicating they are over their mailbox quota. |
AntispamBypass Enabled | If set to True,
this specifies that this mailbox should not have its mail filtered by
the Exchange 2007 content filtering component on the Edge Transport or
Hub Transport server. The default is False. |
UseDatabaseQuota Defaults | If set to False, the mailbox uses the storage quotas set on the mailbox. If set to True
(the default), the mailbox uses the mailbox storage quotas that are
defined for the mailbox database on which the mailbox is located. |
Get-Mailbox matthew.cook | Format-List
Database : MBX-003
DeletedItemFlags : DatabaseDefault
UseDatabaseRetentionDefaults : True
RetainDeletedItemsUntilBackup : False
DeliverToMailboxAndForward : False
LitigationHoldEnabled : False
SingleItemRecoveryEnabled : False
RetentionHoldEnabled : False
EndDateForRetentionHold :
StartDateForRetentionHold :
RetentionComment :
RetentionUrl :
ManagedFolderMailboxPolicy :
RetentionPolicy :
CalendarRepairDisabled : False
ExchangeUserAccountControl : None
MessageTrackingReadStatusEnabled : True
ExternalOofOptions : External
ForwardingAddress :
RetainDeletedItemsFor : 14.00:00:00
IsMailboxEnabled : True
OfflineAddressBook :
ProhibitSendQuota : unlimited
ProhibitSendReceiveQuota : unlimited
RecoverableItemsQuota : unlimited
RecoverableItemsWarningQuota : unlimited
DowngradeHighPriorityMessagesEnabled : False
ProtocolSettings : {}
RecipientLimits : unlimited
IsResource : False
IsLinked : False
IsShared : False
ResourceCapacity :
ResourceCustom : {}
ResourceType :
SamAccountName : Matthew.Cook
SCLDeleteThreshold :
SCLDeleteEnabled :
SCLRejectThreshold :
SCLRejectEnabled :
SCLQuarantineThreshold :
SCLQuarantineEnabled :
SCLJunkThreshold :
SCLJunkEnabled :
AntispamBypassEnabled : False
ServerName : hnlmbx01
UseDatabaseQuotaDefaults : True
IssueWarningQuota : unlimited
RulesQuota : 64 KB (65,536 bytes)
Office :
UserPrincipalName : Matthew.Cook@ithicos.local
UMEnabled : False
MaxSafeSenders :
MaxBlockedSenders :
RssAggregationEnabled : True
Pop3AggregationEnabled : True
WindowsLiveID :
ThrottlingPolicy :
RoleAssignmentPolicy : Default Role Assignment Policy
SharingPolicy : Default Sharing Policy
RemoteAccountPolicy :
MailboxPlan :
ArchiveGuid : 00000000-0000-0000-0000-
000000000000
ArchiveName : {}
ArchiveQuota : unlimited
ArchiveWarningQuota : unlimited
QueryBaseDNRestrictionEnabled : False
MailboxMoveTargetMDB :
MailboxMoveSourceMDB :
MailboxMoveFlags : None
MailboxMoveRemoteHostName :
MailboxMoveBatchName :
MailboxMoveStatus : None
IsPersonToPersonTextMessagingEnabled : False
IsMachineToPersonTextMessagingEnabled : False
UserSMimeCertificate : {}
UserCertificate : {}
CalendarVersionStoreDisabled : False
Extensions : {}
HasPicture : False
HasSpokenName : False
AcceptMessagesOnlyFrom : {}
AcceptMessagesOnlyFromDLMembers : {}
AcceptMessagesOnlyFromSendersOrMembers : {}
AddressListMembership : {\Mailboxes(VLV),
\All Mailboxes(VLV),\All Recipients(VLV), \Default Global
Address List, \All Users}
Alias : MatthewCook
ArbitrationMailbox :
BypassModerationFromSendersOrMembers : {}
OrganizationalUnit : ithicos.local/Corporate
CustomAttribute1 :
CustomAttribute2 :
DisplayName : Matthew Cook
EmailAddresses : {SMTP:MatthewCook@ithicos.local}
GrantSendOnBehalfTo : {}
HiddenFromAddressListsEnabled : False
LegacyExchangeDN : /o=Ithicos Solutions LLC
/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients
/cn=Matthew Cook
MaxSendSize : unlimited
MaxReceiveSize : unlimited
ModeratedBy : {}
ModerationEnabled : False
PoliciesExcluded : {}
EmailAddressPolicyEnabled : True
PrimarySmtpAddress : MatthewCook@ithicos.local
RecipientType : UserMailbox
RecipientTypeDetails : UserMailbox
RejectMessagesFrom : {}
RejectMessagesFromDLMembers : {}
RejectMessagesFromSendersOrMembers : {}
RequireSenderAuthenticationEnabled : False
SimpleDisplayName :
SendModerationNotifications : Always
UMDtmfMap : {emailAddress:62884392665,
lastNameFirstName:26656288439, firstNameLastName:62884392665}
WindowsEmailAddress : MatthewCook@ithicos.local
MailTip :
MailTipTranslations : {}
ExchangeVersion : 0.10 (14.0.100.0)
Name : Matthew Cook
DistinguishedName : CN=Matthew Cook,OU=Corporate,DC=ithicos,DC=local
When you look at these properties, please keep in
mind that not all properties can be modified, even using the EMS. Many
of these properties are system properties and are either created or
managed by the system.
Properties specific to the mailbox using a Client Access server are viewed and set using the Get-CasMailbox and Set-CasMailbox
cmdlets. These include properties related to ActiveSync, Outlook Web
App, POP, IMAP, and MAPI. Here are some of the attributes that can be
set using the Set-CasMailbox cmdlet:
Get-CASMailbox Matthew.Cook | Format-List
EmailAddresses : {SMTP:MatthewCook@ithicos.local}
LegacyExchangeDN : /o=Ithicos Solutions LLC/ou=Exchange
Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=Matthew Cook
LinkedMasterAccount :
PrimarySmtpAddress : MatthewCook@ithicos.local
SamAccountName : Matthew.Cook
ServerLegacyDN : /o=Ithicos Solutions LLC/ou=Exchange
Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers
/cn=HNLMBX01
ServerName : hnlmbx01
DisplayName : Matthew Cook
ActiveSyncAllowedDeviceIDs : {}
ActiveSyncBlockedDeviceIDs : {}
ActiveSyncMailboxPolicy : Default
ActiveSyncMailboxPolicyIsDefaulted : True
ActiveSyncDebugLogging : False
ActiveSyncEnabled : True
HasActiveSyncDevicePartnership : False
OwaMailboxPolicy :
OWAEnabled : True
ECPEnabled : True
EmwsEnabled : False
PopEnabled : True
PopUseProtocolDefaults : True
PopMessagesRetrievalMimeFormat : BestBodyFormat
PopEnableExactRFC822Size : False
PopProtocolLoggingEnabled : False
ImapEnabled : True
ImapUseProtocolDefaults : True
ImapMessagesRetrievalMimeFormat : BestBodyFormat
ImapEnableExactRFC822Size : False
ImapProtocolLoggingEnabled : False
MAPIEnabled : True
MAPIBlockOutlookNonCachedMode : False
MAPIBlockOutlookVersions :
MAPIBlockOutlookRpcHttp : False
IsValid : True
ExchangeVersion : 0.10 (14.0.100.0)
Name : Matthew Cook
DistinguishedName : CN=Matthew Cook,OU=Corporate,
DC=ithicos,DC=local