Changes to Get-Mailbox and New-Mailbox specifically with the Migration parameter

We're simplifying legacy management scenarios and removing some properties from the Get-Mailbox and New-Mailbox -Migration scenario.

When these changes take effect

Beginning November 15, 2026, selected properties will no longer be returned when you use the -Migration switch with the following mailbox cmdlets:

  • Get-Mailbox -Migration
  • New-Mailbox -Migration

Beginning December 15, 2026, the affected properties will be blocked from being configured by using:

  • New-Mailbox -Migration

Review scripts, tools, and other automation that use the -Migration switch, and update any dependencies on the affected properties before these dates.

Affected properties

Category Properties
Custom attributes CustomAttribute1-CustomAttribute13, ExtensionCustomAttribute1-ExtensionCustomAttribute5
Delivery and moderation AcceptMessagesOnlyFrom, AcceptMessagesOnlyFromDLMembers, AcceptMessagesOnlyFromSendersOrMembers, AcceptMessagesOnlyFromWithDisplayNames, AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames, AcceptMessagesOnlyFromDLMembersWithDisplayNames, RejectMessagesFrom, RejectMessagesFromDLMembers, RejectMessagesFromSendersOrMembers, BypassModerationFromSendersOrMembers, ModeratedBy, ModerationEnabled, SendModerationNotifications, GrantSendOnBehalfTo, GrantSendOnBehalfToWithDisplayNames, RequireSenderAuthenticationEnabled, DeliverToMailboxAndForward, ForwardingAddress, ForwardingAddressWithDisplayNames, ForwardingSmtpAddress, MessageCopyForSentAsEnabled, MessageCopyForSendOnBehalfEnabled, MessageCopyForSMTPClientSubmissionEnabled, DowngradeHighPriorityMessagesEnabled, MessageRecallProcessingEnabled
Database and store MailboxContainerGuid, UnifiedMailbox, AggregatedMailboxGuids, DisabledMailboxLocations, ServerName, ServerLegacyDN, MailboxProvisioningConstraint, MailboxProvisioningPreferences, UseDatabaseQuotaDefaults
Archive ArchiveDatabase, ArchiveDatabaseGuid, ArchiveGuid, ArchiveName, ArchiveQuota, ArchiveWarningQuota, ArchiveDomain, ArchiveStatus, ArchiveState, ArchiveRelease, AutoExpandingArchiveEnabled, AutoArchivingEnabled, JournalArchiveAddress, DisabledArchiveDatabase, DisabledArchiveGuid
Point-in-time restore, backup, and soft delete PitrEnabled, PitrCopyIntervalInSeconds, PitrPaused, PitrPausedTimestamp, PitrOffboardedTimestamp, PitrState, M365BackupState, WasInactiveMailbox, IsInactiveMailbox, InactiveMailboxRetireTime, OrphanSoftDeleteTrackingTime, IsSoftDeletedByRemove, IsSoftDeletedByDisable, WhenSoftDeleted, RecipientSoftDeletedStatus, IncludeInGarbageCollection, RetainDeletedItemsFor, SingleItemRecoveryEnabled, RetentionPolicy
Quota (non-shard) CalendarLoggingQuota, RulesQuota, RecipientLimits, MaxReceiveSize
SCL, antispam, and throttling SCLDeleteThreshold, SCLDeleteEnabled, SCLRejectThreshold, SCLRejectEnabled, SCLQuarantineThreshold, SCLQuarantineEnabled, SCLJunkThreshold, SCLJunkEnabled, AntispamBypassEnabled, ThrottlingPolicy, RecipientThrottlingThreshold, MaxSafeSenders, MaxBlockedSenders
Identity and account SamAccountName, WindowsLiveID, MicrosoftOnlineServicesID, NetID, ReconciliationId, SourceAnchor, ExternalDirectoryObjectId, LinkedMasterAccount, AccountDisabled, ExchangeUserAccountControl, ResetPasswordOnNextLogon, StsRefreshTokensValidFrom, UsageLocation, Office, UserIdentityParent, AgentIdentityBlueprintId, IsAgenticUser, IsExchangeCloudManaged, IsDirSynced, SKUAssigned
Resource, room, and public folder IsResource, ResourceCapacity, ResourceCustom, ResourceType, RoomMailboxAccountEnabled, IsLinked, IsShared, IsMonitoringMailbox, IsPublicFolderSystemMailbox, IsRootPublicFolderMailbox, DefaultPublicFolderMailbox, EffectivePublicFolderMailbox
Policies AddressBookPolicy, SharingPolicy, RemoteAccountPolicy, RoleAssignmentPolicy, MailboxPlan, GeneratedOfflineAddressBooks, PoliciesIncluded, PoliciesExcluded, EmailAddressPolicyEnabled
Audit AuditEnabled, AuditLogAgeLimit, AuditAdmin, AuditDelegate, AuditOwner, DefaultAuditSet
Mailbox move MailboxMoveTargetMDB, MailboxMoveSourceMDB, MailboxMoveFlags, MailboxMoveRemoteHostName, MailboxMoveBatchName, MailboxMoveStatus, MailboxRelease, RemoteRecipientType
Hierarchy, protocol, and miscellaneous IsExcludedFromServingHierarchy, IsHierarchyReady, IsHierarchySyncEnabled, HasSnackyAppData, ProtocolSettings, IsMailboxEnabled, MessageTrackingReadStatusEnabled, ExternalOofOptions, CalendarRepairDisabled, CalendarVersionStoreDisabled, ImListMigrationCompleted, Languages, AdminDisplayVersion, ExchangeVersion, ExchangeSecurityDescriptor, EnforcedTimestamps, HttpDeliveryScenario, HttpDeliveryEndpoint, NonCompliantDevices, HasPicture, HasSpokenName, UserSMimeCertificate, UserCertificate, IsPersonToPersonTextMessagingEnabled, IsMachineToPersonTextMessagingEnabled, UMDtmfMap
Shared domain SharedEmailDomainTenant, SharedEmailDomainState, SharedWithTargetSmtpAddress, SharedEmailDomainStateLastModified
Directory and Active Directory ObjectCategory, ObjectClass, OrganizationalUnit, OrganizationalUnitRoot, QueryBaseDN, QueryBaseDNRestrictionEnabled, AddressListMembership, AdministrativeUnits, ArbitrationMailbox, LastExchangeChangedTime, DirectoryObjectVersion, OriginatingServer, IsValid, SimpleDisplayName, WindowsEmailAddress, EmailAddressDisplayNames, MailTip, MailTipTranslations, SharingAnonymousIdentities