Set-OwaMailbox cmdlet sets the properties of the mailbox.

This cmdlet supports risk-mitigation parameters.  

Input parameters

 ParameterTypeMandatory (R/O)DescriptionRestrictions/Valid Values
1 Authentication Information (all parameters)  


(aliases: GUID, DistinguishedName)

ADObjectIDParameter R

A property that is used for managing the OWA mailbox

Value of one of these parameters  can be used as Identity:

1 GUID Globally Unique Identifier (ObjectGuid)
2 DistinguishedName Unique name of the object in Active Directory
3 DeliverAndForwardMail bool O The parameter specifies the message delivery behavior when a ForwardingAddress is specified
  • True - messages are delivered to the current mailbox and forwarded to the specified recipient.

  • False - messages are forwarded and delivered only to the specified recipient. This is the default value.

The value of this parameter is meaningful only if ForwardingAddress is configured.

4 DisplayName string O Name of the mailbox in the list of Control Panel Max length is 256 symbols
5 ForwardingAddress string O A forwarding address for messages that are sent to this mailbox A valid value for this parameter is a recipient of the company.

Recipients: Exchange, POP/IMAP, OWA mailbox, Distribution List, Contact

The default value is null - no forwarding recipient is configured.

6 HideFromAddressBook bool O This  parameter specifies whether this mailbox is visible in the address book
  • True - the mailbox is not visible in the address book.

  • False - the mailbox is visible in the address book. This is the default value.

7 OriginatingServer string O

Address of the server (domain name), where the object physically exists

Note: it is recommended to use this parameter as input to guarantee execution of operation with actual data. To get this parameter use Get-OwaMailbox cmdlet.

Max length is 255 symbols

Output parameters

No parameters

Examples of using Set-OwaMailbox cmdlet

Updating DisplayName:

Set-OwaMailbox -Identity "0CC18AE9-2BAB-435B-B0BF-719372A4D0F2" -DisplayName "Bobby"

Setting the mailbox as hidden from address lists:

Get-OwaMailbox | Set-OwaMailbox -HideFromAddressBook $true