Commands › Exchange Online
Set-MailContact
Modify existing mail contacts.
Quick start script
# Set-MailContact — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-MailContact
$before | Format-List
# 3. Make the change (dry run first)
Set-MailContact -Identity <MailContactIdParameter> -WhatIf
Set-MailContact -Identity <MailContactIdParameter>
# 4. Verify and diff
$after = Get-MailContact
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Set-MailContact [-Identity] <MailContactIdParameter>
[-AcceptMessagesOnlyFrom <MultiValuedProperty>]
[-AcceptMessagesOnlyFromDLMembers <MultiValuedProperty>]
[-AcceptMessagesOnlyFromSendersOrMembers <MultiValuedProperty>]
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-BypassModerationFromSendersOrMembers <MultiValuedProperty>]
[-Confirm]
[-CreateDTMFMap <Boolean>]
[-CustomAttribute1 <String>]
[-CustomAttribute10 <String>]
[-CustomAttribute11 <String>]
[-CustomAttribute12 <String>]
[-CustomAttribute13 <String>]
[-CustomAttribute14 <String>]
[-CustomAttribute15 <String>]
[-CustomAttribute2 <String>]
[-CustomAttribute3 <String>]
[-CustomAttribute4 <String>]
[-CustomAttribute5 <String>]
[-CustomAttribute6 <String>]
[-CustomAttribute7 <String>]
[-CustomAttribute8 <String>]
[-CustomAttribute9 <String>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-EmailAddresses <ProxyAddressCollection>]
[-EmailAddressPolicyEnabled <Boolean>]
[-ExtensionCustomAttribute1 <MultiValuedProperty>]
[-ExtensionCustomAttribute2 <MultiValuedProperty>]
[-ExtensionCustomAttribute3 <MultiValuedProperty>]
[-ExtensionCustomAttribute4 <MultiValuedProperty>]
[-ExtensionCustomAttribute5 <MultiValuedProperty>]
[-ExternalEmailAddress <ProxyAddress>]
[-ForceUpgrade]
[-GrantSendOnBehalfTo <MultiValuedProperty>]
[-HiddenFromAddressListsEnabled <Boolean>]
[-IgnoreDefaultScope]
[-MacAttachmentFormat <MacAttachmentFormat>]
[-MailTip <String>]
[-MailTipTranslations <MultiValuedProperty>]
[-MaxReceiveSize <Unlimited>]
[-MaxRecipientPerMessage <Unlimited>]
[-MaxSendSize <Unlimited>]
[-MessageBodyFormat <MessageBodyFormat>]
[-MessageFormat <MessageFormat>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-Name <String>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RejectMessagesFrom <MultiValuedProperty>]
[-RejectMessagesFromDLMembers <MultiValuedProperty>]
[-RejectMessagesFromSendersOrMembers <MultiValuedProperty>]
[-RemovePicture]
[-RemoveSpokenName]
[-RequireSenderAuthenticationEnabled <Boolean>]
[-SecondaryAddress <String>]
[-SecondaryDialPlan <UMDialPlanIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-SimpleDisplayName <String>]
[-UMDtmfMap <MultiValuedProperty>]
[-UseMapiRichTextFormat <UseMapiRichTextFormat>]
[-UsePreferMessageFormat <Boolean>]
[-UserCertificate <MultiValuedProperty>]
[-UserSMimeCertificate <MultiValuedProperty>]
[-WhatIf]
[-WindowsEmailAddress <SmtpAddress>]
[<CommonParameters>]Parameters (67)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Identity | MailContactIdParameter | yes | The Identity parameter specifies the mail contact that you want to modify. You can use any value that uniquely identifies the mail contact. For example: |
| -AcceptMessagesOnlyFrom | MultiValuedProperty | The AcceptMessagesOnlyFrom parameter specifies who is allowed to send messages to this recipient. Messages from other senders are rejected. | |
| -AcceptMessagesOnlyFromDLMembers | MultiValuedProperty | The AcceptMessagesOnlyFromDLMembers parameter specifies who is allowed to send messages to this recipient. Messages from other senders are rejected. | |
| -AcceptMessagesOnlyFromSendersOrMembers | MultiValuedProperty | The AcceptMessagesOnlyFromSendersOrMembers parameter specifies who is allowed to send messages to this recipient. Messages from other senders are rejected. | |
| -Alias | String | The Alias parameter specifies the Exchange alias (also known as the mail nickname) for the recipient. This value identifies the recipient as a mail-enabled object, and shouldn't be confused with multiple email... | |
| -ArbitrationMailbox | MailboxIdParameter | This parameter is available only in on-premises Exchange. | |
| -BypassModerationFromSendersOrMembers | MultiValuedProperty | The BypassModerationFromSendersOrMembers parameter specifies who is allowed to send messages to this moderated recipient without approval from a moderator. Valid values for this parameter are individual senders and... | |
| -Confirm | SwitchParameter | The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding. | |
| -CreateDTMFMap | Boolean | This parameter is available only in on-premises Exchange. | |
| -CustomAttribute1 | String | This parameter specifies a value for the CustomAttribute1 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute10 | String | This parameter specifies a value for the CustomAttribute10 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute11 | String | This parameter specifies a value for the CustomAttribute11 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute12 | String | This parameter specifies a value for the CustomAttribute12 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute13 | String | This parameter specifies a value for the CustomAttribute13 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute14 | String | This parameter specifies a value for the CustomAttribute14 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute15 | String | This parameter specifies a value for the CustomAttribute15 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute2 | String | This parameter specifies a value for the CustomAttribute2 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute3 | String | This parameter specifies a value for the CustomAttribute3 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute4 | String | This parameter specifies a value for the CustomAttribute4 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute5 | String | This parameter specifies a value for the CustomAttribute5 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute6 | String | This parameter specifies a value for the CustomAttribute6 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute7 | String | This parameter specifies a value for the CustomAttribute7 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute8 | String | This parameter specifies a value for the CustomAttribute8 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -CustomAttribute9 | String | This parameter specifies a value for the CustomAttribute9 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. The maximum... | |
| -DisplayName | String | The DisplayName parameter specifies the display name of the mail contact. The display name is visible in the Exchange admin center (EAC) and in address lists. The maximum length is 256 characters. If the value... | |
| -DomainController | Fqdn | This parameter is available only in on-premises Exchange. | |
| -EmailAddresses | ProxyAddressCollection | The EmailAddresses parameter specifies all email addresses (proxy addresses) for the recipient, including the primary SMTP address. In on-premises Exchange organizations, the primary SMTP address and other proxy... | |
| -EmailAddressPolicyEnabled | Boolean | This parameter is available only in on-premises Exchange. | |
| -ExtensionCustomAttribute1 | MultiValuedProperty | This parameter specifies a value for the ExtensionCustomAttribute1 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. You... | |
| -ExtensionCustomAttribute2 | MultiValuedProperty | This parameter specifies a value for the ExtensionCustomAttribute2 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. You... | |
| -ExtensionCustomAttribute3 | MultiValuedProperty | This parameter specifies a value for the ExtensionCustomAttribute3 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. You... | |
| -ExtensionCustomAttribute4 | MultiValuedProperty | This parameter specifies a value for the ExtensionCustomAttribute4 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. You... | |
| -ExtensionCustomAttribute5 | MultiValuedProperty | This parameter specifies a value for the ExtensionCustomAttribute5 property on the recipient. You can use this property to store custom information about the recipient, and to identify the recipient in filters. You... | |
| -ExternalEmailAddress | ProxyAddress | The ExternalEmailAddress parameter specifies the target email address of the mail contact or mail user. By default, this value is used as the primary email address of the mail contact or mail user. | |
| -ForceUpgrade | SwitchParameter | The ForceUpgrade switch suppresses the confirmation message that appears if the object was created in a previous version of Exchange. You don't need to specify a value with this switch. | |
| -GrantSendOnBehalfTo | MultiValuedProperty | The GrantSendOnBehalfTo parameter specifies who can send on behalf of this mail contact. Although messages sent on behalf of the mail contact clearly show the sender in the From field (`<Sender> on behalf of <Mail... | |
| -HiddenFromAddressListsEnabled | Boolean | The HiddenFromAddressListsEnabled parameter specifies whether this recipient is visible in address lists. Valid values are: | |
| -IgnoreDefaultScope | SwitchParameter | This parameter is available only in on-premises Exchange. | |
| -MacAttachmentFormat | MacAttachmentFormat | The MacAttachmentFormat parameter specifies the Apple Macintosh operating system attachment format to use for messages sent to the mail contact or mail user. Valid values are: | |
| -MailTip | String | The MailTip parameter specifies the custom MailTip text for this recipient. The MailTip is shown to senders when they start drafting an email message to this recipient. If the value contains spaces, enclose the value... | |
| -MailTipTranslations | MultiValuedProperty | The MailTipTranslations parameter specifies additional languages for the custom MailTip text that's defined by the MailTip parameter. HTML tags are automatically added to the MailTip translation, additional HTML tags... | |
| -MaxReceiveSize | Unlimited | This parameter is available only in on-premises Exchange. | |
| -MaxRecipientPerMessage | Unlimited | This parameter is available only in on-premises Exchange. | |
| -MaxSendSize | Unlimited | This parameter is available only in on-premises Exchange. | |
| -MessageBodyFormat | MessageBodyFormat | The MessageBodyFormat parameter specifies the message body format for messages sent to the mail contact or mail user. Valid values are: | |
| -MessageFormat | MessageFormat | The MessageFormat parameter specifies the message format for messages sent to the mail contact or mail user. Valid values are: | |
| -ModeratedBy | MultiValuedProperty | The ModeratedBy parameter specifies one or more moderators for this recipient. A moderator approves messages sent to the recipient before the messages are delivered. A moderator must be a mailbox, mail user, or mail... | |
| -ModerationEnabled | Boolean | The ModerationEnabled parameter specifies whether moderation is enabled for this recipient. Valid value are: | |
| -Name | String | The Name parameter specifies the unique name of the mail contact. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks ("). | |
| -PrimarySmtpAddress | SmtpAddress | This parameter is available only in on-premises Exchange. | |
| -RejectMessagesFrom | MultiValuedProperty | The RejectMessagesFrom parameter specifies who isn't allowed to send messages to this recipient. Messages from these senders are rejected. | |
| -RejectMessagesFromDLMembers | MultiValuedProperty | The RejectMessagesFromDLMembers parameter specifies who isn't allowed to send messages to this recipient. Messages from these senders are rejected. | |
| -RejectMessagesFromSendersOrMembers | MultiValuedProperty | The RejectMessagesFromSendersOrMembers parameter specifies who isn't allowed to send messages to this recipient. Messages from these senders are rejected. | |
| -RemovePicture | SwitchParameter | This parameter is available only in on-premises Exchange. | |
| -RemoveSpokenName | SwitchParameter | This parameter is available only in on-premises Exchange. | |
| -RequireSenderAuthenticationEnabled | Boolean | The RequireSenderAuthenticationEnabled parameter specifies whether to accept messages only from authenticated (internal) senders. Valid values are: | |
| -SecondaryAddress | String | This parameter is available only in on-premises Exchange. | |
| -SecondaryDialPlan | UMDialPlanIdParameter | This parameter is available only in on-premises Exchange. | |
| -SendModerationNotifications | TransportModerationNotificationFlags | The SendModerationNotifications parameter specifies when moderation notification messages are sent. Valid values are: | |
| -SimpleDisplayName | String | The SimpleDisplayName parameter is used to display an alternative description of the object when only a limited set of characters is permitted. Valid characters are: | |
| -UMDtmfMap | MultiValuedProperty | This parameter is available only in on-premises Exchange. | |
| -UseMapiRichTextFormat | UseMapiRichTextFormat | The UseMapiRichTextFormat parameter specifies what to do with messages that are sent to the mail user or mail contact in MAPI rich text format, also known as Outlook Rich Text or Transport Neutral Encapsulation... | |
| -UsePreferMessageFormat | Boolean | The UsePreferMessageFormat specifies whether the message format settings configured for the mail user or mail contact override the global settings configured for the remote domain or configured by the message sender.... | |
| -UserCertificate | MultiValuedProperty | This parameter is available only in the cloud-based service. | |
| -UserSMimeCertificate | MultiValuedProperty | This parameter is available only in the cloud-based service. | |
| -WhatIf | SwitchParameter | The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch. | |
| -WindowsEmailAddress | SmtpAddress | The WindowsEmailAddress parameter specifies the Windows email address for this recipient. This is a common Active Directory attribute that's present in all environments, including environments without Exchange. Using... |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.