diff --git a/exchange/exchange-ps/ExchangePowerShell/Set-MailUser.md b/exchange/exchange-ps/ExchangePowerShell/Set-MailUser.md index 1366560786..a6a29fe421 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Set-MailUser.md +++ b/exchange/exchange-ps/ExchangePowerShell/Set-MailUser.md @@ -21,7 +21,7 @@ For information about the parameter sets in the Syntax section below, see [Excha ## SYNTAX -### Default +### Identity (Default) ``` Set-MailUser [-Identity] [-AcceptMessagesOnlyFrom ] @@ -149,6 +149,8 @@ Set-MailUser [-Identity] [-EnableLitigationHoldForMigratio [-MailTip ] [-MailTipTranslations ] [-MailboxRegion ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -178,6 +180,80 @@ Set-MailUser [-Identity] [-EnableLitigationHoldForMigratio [] ``` +### ExcludeFromAllHolds +``` +Set-MailUser [-Identity] [-ExcludeFromAllHolds] + [-AcceptMessagesOnlyFrom ] + [-AcceptMessagesOnlyFromDLMembers ] + [-AcceptMessagesOnlyFromSendersOrMembers ] + [-Alias ] + [-ArchiveGuid ] + [-BypassModerationFromSendersOrMembers ] + [-Confirm] + [-CustomAttribute1 ] + [-CustomAttribute10 ] + [-CustomAttribute11 ] + [-CustomAttribute12 ] + [-CustomAttribute13 ] + [-CustomAttribute14 ] + [-CustomAttribute15 ] + [-CustomAttribute2 ] + [-CustomAttribute3 ] + [-CustomAttribute4 ] + [-CustomAttribute5 ] + [-CustomAttribute6 ] + [-CustomAttribute7 ] + [-CustomAttribute8 ] + [-CustomAttribute9 ] + [-DataEncryptionPolicy ] + [-DisplayName ] + [-EmailAddresses ] + [-ExchangeGuid ] + [-ExtensionCustomAttribute1 ] + [-ExtensionCustomAttribute2 ] + [-ExtensionCustomAttribute3 ] + [-ExtensionCustomAttribute4 ] + [-ExtensionCustomAttribute5 ] + [-ExternalEmailAddress ] + [-FederatedIdentity ] + [-ForceUpgrade] + [-GrantSendOnBehalfTo ] + [-HiddenFromAddressListsEnabled ] + [-HVEAccount] + [-ImmutableId ] + [-JournalArchiveAddress ] + [-MacAttachmentFormat ] + [-MailTip ] + [-MailTipTranslations ] + [-MailboxRegion ] + [-MaxReceiveSize ] + [-MaxSendSize ] + [-MessageBodyFormat ] + [-MessageFormat ] + [-MicrosoftOnlineServicesID ] + [-ModeratedBy ] + [-ModerationEnabled ] + [-Name ] + [-Password ] + [-PrimarySmtpAddress ] + [-RecipientLimits ] + [-RejectMessagesFrom ] + [-RejectMessagesFromDLMembers ] + [-RejectMessagesFromSendersOrMembers ] + [-RemoveMailboxProvisioningConstraint] + [-RequireSenderAuthenticationEnabled ] + [-ResetPasswordOnNextLogon ] + [-SendModerationNotifications ] + [-SimpleDisplayName ] + [-UseMapiRichTextFormat ] + [-UsePreferMessageFormat ] + [-UserCertificate ] + [-UserSMimeCertificate ] + [-WhatIf] + [-WindowsEmailAddress ] + [] +``` + ### ExcludeFromAllOrgHolds ``` Set-MailUser [-Identity] [-ExcludeFromAllOrgHolds] @@ -225,6 +301,8 @@ Set-MailUser [-Identity] [-ExcludeFromAllOrgHolds] [-MailTip ] [-MailTipTranslations ] [-MailboxRegion ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -301,6 +379,8 @@ Set-MailUser [-Identity] [-ExcludeFromOrgHolds ] [-MailboxRegion ] [-MailTip ] [-MailTipTranslations ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -377,6 +457,8 @@ Set-MailUser [-Identity] [-RecalculateInactiveMailUser] [-MailboxRegion ] [-MailTip ] [-MailTipTranslations ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -453,6 +535,8 @@ Set-MailUser [-Identity] [-RemoveComplianceTagHoldApplied] [-MailboxRegion ] [-MailTip ] [-MailTipTranslations ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -529,6 +613,8 @@ Set-MailUser [-Identity] [-RemoveDelayHoldApplied] [-MailTip ] [-MailTipTranslations ] [-MailboxRegion ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -605,6 +691,8 @@ Set-MailUser [-Identity] [-RemoveDelayReleaseHoldApplied] [-MailTip ] [-MailTipTranslations ] [-MailboxRegion ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -680,6 +768,8 @@ Set-MailUser [-Identity] [-RemoveDisabledArchive] [-MailboxRegion ] [-MailTip ] [-MailTipTranslations ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -754,6 +844,8 @@ Set-MailUser [-Identity] [-RemoveLitigationHoldEnabled] [-MailTip ] [-MailTipTranslations ] [-MailboxRegion ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -830,6 +922,8 @@ Set-MailUser [-Identity] [-RemoveOrphanedHolds ] [-MailTip ] [-MailTipTranslations ] [-MailboxRegion ] + [-MaxReceiveSize ] + [-MaxSendSize ] [-MessageBodyFormat ] [-MessageFormat ] [-MicrosoftOnlineServicesID ] @@ -945,6 +1039,13 @@ Set-MailUser -Identity "John Woods" -ExternalEmailAddress john@tailspintoys.com This example modifies the external email address for the mail user named John Woods. The original external email address isn't kept as a proxy address. +### Example 2 +```powershell +Set-MailUser -Identity "John Woods" -ExcludeFromAllHolds +``` + +In Exchange Online, this example excludes the mail user from applicable retention and app retention policies. These policies includes organization-level retention policies, user-level retention policies, compliance tag holds, delay holds, and delay release holds. The switch doesn't remove eDiscovery holds, litigation holds, or restrictive retention policies. + ## PARAMETERS ### -Identity @@ -1136,7 +1237,7 @@ The ArbitrationMailbox parameter specifies the arbitration mailbox that's used t ```yaml Type: MailboxIdParameter -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -1174,7 +1275,7 @@ This parameter is reserved for internal Microsoft use. ```yaml Type: MultiValuedProperty -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -1585,7 +1686,7 @@ The DomainController parameter specifies the domain controller that's used by th ```yaml Type: Fqdn -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -1647,7 +1748,7 @@ The EmailAddressPolicyEnabled parameter specifies whether to apply email address ```yaml Type: Boolean -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -1697,6 +1798,45 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -ExcludeFromAllHolds + +> Applicable: Exchange Online, Exchange Online Protection + +This parameter is available only in the cloud-based service. + +The ExcludeFromAllHolds switch enables the deletion of soft deleted or inactive mail users by removing certain types of holds while preserving compliance requirements. You don't need to specify a value with this switch. + +This switch removes the following types of holds: + +- Organization-level retention policies and app retention policies. +- User-level retention policies and app retention policies. +- Compliance tag holds (is only removed when no restrictive policies exist). +- Delay holds (temporary holds during policy transitions). +- Delay release holds (holds that prevent immediate deletion during policy changes). + +This switch doesn't remove the following types of holds: + +- eDiscovery holds (maintained for compliance). +- Litigation holds (maintained for compliance). +- Restrictive retention policies (preserved for compliance rules). +- Policy configurations (doesn't update policy exclusion lists). + +After you use this switch in a **Set-MailUser** command on an inactive mail user, run the following **Get-MailUser** command to confirm the results: + +`Get-MailUser -SoftDeletedMailUser -Identity "former.user@contoso.com" | Format-List Name,InPlaceHolds,IsInactiveMailbox` + +```yaml +Type: SwitchParameter +Parameter Sets: ExcludeFromAllHolds +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -ExcludeFromAllOrgHolds > Applicable: Exchange Online, Exchange Online Protection @@ -2016,7 +2156,7 @@ This switch enables the command to access Active Directory objects that aren't c ```yaml Type: SwitchParameter -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -2184,7 +2324,7 @@ Base64 encoding increases the size of messages by approximately 33%, so specify ```yaml Type: Unlimited -Parameter Sets: Default +Parameter Sets: (All) Aliases: Required: False @@ -2215,7 +2355,7 @@ Base64 encoding increases the size of messages by approximately 33%, so specify ```yaml Type: Unlimited -Parameter Sets: Default +Parameter Sets: (All) Aliases: Required: False @@ -2492,7 +2632,7 @@ The RecoverableItemsQuota value must be greater than or equal to the Recoverable ```yaml Type: Unlimited -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -2526,7 +2666,7 @@ The RecoverableItemsQuota value must be greater than or equal to the Recoverable ```yaml Type: Unlimited -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -2797,7 +2937,7 @@ You can add a picture to a mail user by using the Import-RecipientDataProperty c ```yaml Type: SwitchParameter -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -2819,7 +2959,7 @@ You can add a sound file to a mail user by using the Import-RecipientDataPropert ```yaml Type: SwitchParameter -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -2885,7 +3025,7 @@ The SamAccountName parameter (also known as the pre-Windows 2000 user account or ```yaml Type: String -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -2993,7 +3133,7 @@ This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -3025,7 +3165,7 @@ If you use this syntax, you don't need to specify all of the DTMF map values, an ```yaml Type: MultiValuedProperty -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False @@ -3128,7 +3268,7 @@ The UserPrincipalName parameter specifies the logon name for the user account. T ```yaml Type: String -Parameter Sets: Default +Parameter Sets: Identity Aliases: Required: False diff --git a/exchange/exchange-ps/ExchangePowerShell/Set-Mailbox.md b/exchange/exchange-ps/ExchangePowerShell/Set-Mailbox.md index c25b40f69f..499f8e6513 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Set-Mailbox.md +++ b/exchange/exchange-ps/ExchangePowerShell/Set-Mailbox.md @@ -47,6 +47,7 @@ Set-Mailbox [-Identity] [-AuditLog] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-AuxAuditLog] [-BypassModerationFromSendersOrMembers ] [-CalendarLoggingQuota ] @@ -224,6 +225,7 @@ Set-Mailbox [-Identity] [-ExcludeFromAllHolds] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] [-CalendarVersionStoreDisabled ] @@ -334,8 +336,7 @@ Set-Mailbox [-Identity] [-ExcludeFromAllHolds] ### ExcludeFromAllOrgHolds ``` -Set-Mailbox [-Identity] - [-ExcludeFromAllOrgHolds] +Set-Mailbox [-Identity] [-ExcludeFromAllOrgHolds] [-AcceptMessagesOnlyFrom ] [-AcceptMessagesOnlyFromDLMembers ] [-AcceptMessagesOnlyFromSendersOrMembers ] @@ -349,6 +350,7 @@ Set-Mailbox [-Identity] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-AuxAuditLog] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] @@ -481,6 +483,7 @@ Set-Mailbox [-Identity] [-ExcludeFromOrgHolds ] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-AuxAuditLog] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] @@ -613,6 +616,7 @@ Set-Mailbox [-Identity] -IsExchangeCloudManaged [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] [-CalendarVersionStoreDisabled ] @@ -722,10 +726,135 @@ Set-Mailbox [-Identity] -IsExchangeCloudManaged [] ``` +### ProvideConsent +``` +Set-Mailbox [-Identity] [-ProvideConsent] + [-AcceptMessagesOnlyFrom ] + [-AcceptMessagesOnlyFromDLMembers ] + [-AcceptMessagesOnlyFromSendersOrMembers ] + [-AccountDisabled ] + [-AddressBookPolicy ] + [-Alias ] + [-ApplyMandatoryProperties] + [-ArchiveName ] + [-AuditAdmin ] + [-AuditDelegate ] + [-AuditEnabled ] + [-AuditLogAgeLimit ] + [-AuditOwner ] + [-AutoArchivingEnabled ] + [-BypassModerationFromSendersOrMembers ] + [-CalendarRepairDisabled ] + [-CalendarVersionStoreDisabled ] + [-ClearThrottlingPolicyAssignment] + [-Confirm] + [-CustomAttribute1 ] + [-CustomAttribute10 ] + [-CustomAttribute11 ] + [-CustomAttribute12 ] + [-CustomAttribute13 ] + [-CustomAttribute14 ] + [-CustomAttribute15 ] + [-CustomAttribute2 ] + [-CustomAttribute3 ] + [-CustomAttribute4 ] + [-CustomAttribute5 ] + [-CustomAttribute6 ] + [-CustomAttribute7 ] + [-CustomAttribute8 ] + [-CustomAttribute9 ] + [-DataEncryptionPolicy ] + [-DefaultAuditSet ] + [-DefaultPublicFolderMailbox ] + [-DeliverToMailboxAndForward ] + [-DisplayName ] + [-ElcProcessingDisabled ] + [-EmailAddressDisplayNames ] + [-EmailAddresses ] + [-EnableRoomMailboxAccount ] + [-EndDateForRetentionHold ] + [-EnforcedTimestamps ] + [-ExtensionCustomAttribute1 ] + [-ExtensionCustomAttribute2 ] + [-ExtensionCustomAttribute3 ] + [-ExtensionCustomAttribute4 ] + [-ExtensionCustomAttribute5 ] + [-ExternalOofOptions ] + [-Force] + [-ForwardingAddress ] + [-ForwardingSmtpAddress ] + [-GrantSendOnBehalfTo ] + [-GroupMailbox] + [-HiddenFromAddressListsEnabled ] + [-ImmutableId ] + [-InactiveMailbox] + [-IsExcludedFromServingHierarchy ] + [-IssueWarningQuota ] + [-JournalArchiveAddress ] + [-Languages ] + [-LitigationHoldDate ] + [-LitigationHoldDuration ] + [-LitigationHoldEnabled ] + [-LitigationHoldOwner ] + [-MailboxRegion ] + [-MailTip ] + [-MailTipTranslations ] + [-MaxReceiveSize ] + [-MaxSendSize ] + [-MessageCopyForSendOnBehalfEnabled ] + [-MessageCopyForSentAsEnabled ] + [-MessageCopyForSMTPClientSubmissionEnabled ] + [-MessageTrackingReadStatusEnabled ] + [-MicrosoftOnlineServicesID ] + [-ModeratedBy ] + [-ModerationEnabled ] + [-Name ] + [-NonCompliantDevices ] + [-Office ] + [-Password ] + [-ProhibitSendQuota ] + [-ProhibitSendReceiveQuota ] + [-ProvisionedForOfficeGraph] + [-PublicFolder] + [-RecipientLimits ] + [-RejectMessagesFrom ] + [-RejectMessagesFromDLMembers ] + [-RejectMessagesFromSendersOrMembers ] + [-RemoveMailboxProvisioningConstraint] + [-RequireSenderAuthenticationEnabled ] + [-ResourceCapacity ] + [-ResourceCustom ] + [-RetainDeletedItemsFor ] + [-RetentionComment ] + [-RetentionHoldEnabled ] + [-RetentionPolicy ] + [-RetentionUrl ] + [-RoleAssignmentPolicy ] + [-RoomMailboxPassword ] + [-RulesQuota ] + [-SchedulerAssistant ] + [-SendModerationNotifications ] + [-SharingPolicy ] + [-SimpleDisplayName ] + [-SingleItemRecoveryEnabled ] + [-StartDateForRetentionHold ] + [-StsRefreshTokensValidFrom ] + [-Type ] + [-UniqueRecipientsCountLimitLevel ] + [-UniqueUnrestrictedGroupsLimitEnabled ] + [-UpdateEnforcedTimestamp] + [-UseDatabaseQuotaDefaults ] + [-UseDatabaseRetentionDefaults ] + [-UserCertificate ] + [-UserSMimeCertificate ] + [-WindowsEmailAddress ] + [-WhatIf] + [] + ``` + ### RecalculateInactiveMailbox ``` -Set-Mailbox [-Identity] - [-RecalculateInactiveMailbox] +Set-Mailbox [-Identity] [-RecalculateInactiveMailbox] [-AcceptMessagesOnlyFrom ] [-AcceptMessagesOnlyFromDLMembers ] [-AcceptMessagesOnlyFromSendersOrMembers ] @@ -739,6 +868,7 @@ Set-Mailbox [-Identity] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-AuxAuditLog] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] @@ -855,6 +985,132 @@ Set-Mailbox [-Identity] [] ``` +### RemoveComplianceTagHoldApplied +``` +Set-Mailbox [-Identity] [-ProvideConsent] [-RemoveComplianceTagHoldApplied] + [-AcceptMessagesOnlyFrom ] + [-AcceptMessagesOnlyFromDLMembers ] + [-AcceptMessagesOnlyFromSendersOrMembers ] + [-AccountDisabled ] + [-AddressBookPolicy ] + [-Alias ] + [-ApplyMandatoryProperties] + [-ArchiveName ] + [-AuditAdmin ] + [-AuditDelegate ] + [-AuditEnabled ] + [-AuditLogAgeLimit ] + [-AuditOwner ] + [-AutoArchivingEnabled ] + [-BypassModerationFromSendersOrMembers ] + [-CalendarRepairDisabled ] + [-CalendarVersionStoreDisabled ] + [-ClearThrottlingPolicyAssignment] + [-Confirm] + [-CustomAttribute1 ] + [-CustomAttribute10 ] + [-CustomAttribute11 ] + [-CustomAttribute12 ] + [-CustomAttribute13 ] + [-CustomAttribute14 ] + [-CustomAttribute15 ] + [-CustomAttribute2 ] + [-CustomAttribute3 ] + [-CustomAttribute4 ] + [-CustomAttribute5 ] + [-CustomAttribute6 ] + [-CustomAttribute7 ] + [-CustomAttribute8 ] + [-CustomAttribute9 ] + [-DataEncryptionPolicy ] + [-DefaultAuditSet ] + [-DefaultPublicFolderMailbox ] + [-DeliverToMailboxAndForward ] + [-DisplayName ] + [-ElcProcessingDisabled ] + [-EmailAddressDisplayNames ] + [-EmailAddresses ] + [-EnableRoomMailboxAccount ] + [-EndDateForRetentionHold ] + [-EnforcedTimestamps ] + [-ExtensionCustomAttribute1 ] + [-ExtensionCustomAttribute2 ] + [-ExtensionCustomAttribute3 ] + [-ExtensionCustomAttribute4 ] + [-ExtensionCustomAttribute5 ] + [-ExternalOofOptions ] + [-Force] + [-ForwardingAddress ] + [-ForwardingSmtpAddress ] + [-GrantSendOnBehalfTo ] + [-GroupMailbox] + [-HiddenFromAddressListsEnabled ] + [-ImmutableId ] + [-InactiveMailbox] + [-IsExcludedFromServingHierarchy ] + [-IssueWarningQuota ] + [-JournalArchiveAddress ] + [-Languages ] + [-LitigationHoldDate ] + [-LitigationHoldDuration ] + [-LitigationHoldEnabled ] + [-LitigationHoldOwner ] + [-MailboxRegion ] + [-MailTip ] + [-MailTipTranslations ] + [-MaxReceiveSize ] + [-MaxSendSize ] + [-MessageCopyForSendOnBehalfEnabled ] + [-MessageCopyForSentAsEnabled ] + [-MessageCopyForSMTPClientSubmissionEnabled ] + [-MessageTrackingReadStatusEnabled ] + [-MicrosoftOnlineServicesID ] + [-ModeratedBy ] + [-ModerationEnabled ] + [-Name ] + [-NonCompliantDevices ] + [-Office ] + [-Password ] + [-ProhibitSendQuota ] + [-ProhibitSendReceiveQuota ] + [-ProvisionedForOfficeGraph] + [-PublicFolder] + [-RecipientLimits ] + [-RejectMessagesFrom ] + [-RejectMessagesFromDLMembers ] + [-RejectMessagesFromSendersOrMembers ] + [-RemoveMailboxProvisioningConstraint] + [-RequireSenderAuthenticationEnabled ] + [-ResourceCapacity ] + [-ResourceCustom ] + [-RetainDeletedItemsFor ] + [-RetentionComment ] + [-RetentionHoldEnabled ] + [-RetentionPolicy ] + [-RetentionUrl ] + [-RoleAssignmentPolicy ] + [-RoomMailboxPassword ] + [-RulesQuota ] + [-SchedulerAssistant ] + [-SendModerationNotifications ] + [-SharingPolicy ] + [-SimpleDisplayName ] + [-SingleItemRecoveryEnabled ] + [-StartDateForRetentionHold ] + [-StsRefreshTokensValidFrom ] + [-Type ] + [-UniqueRecipientsCountLimitLevel ] + [-UniqueUnrestrictedGroupsLimitEnabled ] + [-UpdateEnforcedTimestamp] + [-UseDatabaseQuotaDefaults ] + [-UseDatabaseRetentionDefaults ] + [-UserCertificate ] + [-UserSMimeCertificate ] + [-WindowsEmailAddress ] + [-WhatIf] + [] + ``` + ### RemoveDelayHoldApplied ``` Set-Mailbox [-Identity] @@ -872,6 +1128,7 @@ Set-Mailbox [-Identity] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-AuxAuditLog] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] @@ -1005,6 +1262,7 @@ Set-Mailbox [-Identity] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] [-CalendarVersionStoreDisabled ] @@ -1136,6 +1394,7 @@ Set-Mailbox [-Identity] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] [-CalendarVersionStoreDisabled ] @@ -1268,6 +1527,7 @@ Set-Mailbox [-Identity] [-AuditEnabled ] [-AuditLogAgeLimit ] [-AuditOwner ] + [-AutoArchivingEnabled ] [-BypassModerationFromSendersOrMembers ] [-CalendarRepairDisabled ] [-CalendarVersionStoreDisabled ] @@ -1450,6 +1710,27 @@ Set-Mailbox -Identity asraf@contoso.com -RemoveDelayReleaseHoldApplied In Exchange Online, this example removes the delay hold that's applied to Asraf's mailbox so an offboarding migration (that is, a mailbox migration from Exchange Online back to on-premises Exchange) can continue successfully. For more information about delay holds, see [Managing mailboxes on delay hold](https://learn.microsoft.com/purview/ediscovery-identify-a-hold-on-an-exchange-online-mailbox#managing-mailboxes-on-delay-hold). +### Example 9 +```powershell +Set-Mailbox -Identity akia@contoso.com -InactiveMailbox -RemoveComplianceTagHoldApplied +``` + +In Exchange Online, this example removes compliance tag holds from the specified inactive mailbox. Because the mailbox is inactive, the ProvideConsent switch isn't required. + +### Example 10 +```powershell +Set-Mailbox -Identity valeria@contoso.com -RemoveComplianceTagHoldApplied -ProvideConsent +``` + +In Exchange Online, this example removes compliance tag holds from the specified active mailbox. The ProvideConsent switch is required to acknowledge you understand the implications of removing the hold from an active mailbox, which might result in the permanent deletion of content that was previously protected. + +### Example 11 +```powershell +Set-Mailbox -Identity "Sales Team" -GroupMailbox -ExcludeFromAllHolds +``` + +In Exchange Online, this example removes all eligible holds from the Microsoft 365 Group mailbox named Sales Team. This removal includes organization-level retention policies, user-level retention policies, compliance tag holds, delay holds, and delay release holds. The switch doesn't remove eDiscovery holds, litigation holds, or restrictive retention policies. + ## PARAMETERS ### -Identity @@ -2146,6 +2427,26 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -AutoArchivingEnabled + +> Applicable: Exchange Online + +This parameter is available only in the cloud-based service. + +{{ Fill AutoArchivingEnabled Description }} + +```yaml +Type: Boolean +Parameter Sets: Identity, ExcludeFromAllHolds, ExcludeFromAllOrgHolds, ExcludeFromOrgHolds, IsExchangeCloudManaged, ProvideConsent, RecalculateInactiveMailbox, RemoveComplianceTagHoldApplied, RemoveDelayHoldApplied, RemoveDelayReleaseHoldApplied, RemoveDisabledArchive, RemoveOrphanedHolds +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -AuxAuditLog > Applicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE @@ -3075,7 +3376,7 @@ Accept wildcard characters: False This parameter is available only in the cloud-based service. -The ExcludeFromAllHolds switch permanetly deletes inactive mailboxes by removing holds while preserving complaince requirements. You don't need to specific a value with this switch. +The ExcludeFromAllHolds switch allow admins to permanently delete inactive mailboxes and group mailboxes by removing certain types of holds while preserving compliance requirements. You don't need to specify a value with this switch. This switch removes the following types of holds: @@ -3094,7 +3395,11 @@ This switch doesn't remove the following types of holds: After you use this switch in a **Set-Mailbox** command on an inactive mailbox, run the following **Get-Mailbox** command to confirm the results: -`Get-Mailbox -InactiveMailboxOnly -Identity "lila@contoso.com" | Format-List Name,InPlaceHolds,IsInactiveMailbox` +`Get-Mailbox -SoftDeletedMailbox -Identity "lila@contoso.com" | Format-List Name,InPlaceHolds,IsInactiveMailbox` + +For group mailboxes, you can verify the hold status using: + +`Get-Mailbox -GroupMailbox -Identity "salesteam@contoso.com" -SoftDeletedMailbox | Format-List Name,InPlaceHolds,IsInactiveMailbox` ```yaml Type: SwitchParameter @@ -4868,6 +5173,34 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -ProvideConsent + +> Applicable: Exchange Online, Exchange Online Protection + +This parameter is available only in the cloud-based service. + +The ProvideConsent switch acknowledges that you understand the implications of removing compliance tag holds from an active mailbox. You don't need to specify a value with this switch. + +This switch is required when using the RemoveComplianceTagHoldApplied switch to remove compliance tag holds from active mailboxes. By providing consent, you acknowledge the following statements: + +- Removing the compliance tag hold might result in the permanent deletion of the mailbox that was previously protected by the hold. +- This action might have legal or compliance implications for your organization. +- Once the hold is removed and content is deleted, the content can't be recovered. + +This switch is not required when removing compliance tag holds from inactive mailboxes. + +```yaml +Type: SwitchParameter +Parameter Sets: ProvideConsent, RemoveComplianceTagHoldApplied +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -ProvisionedForOfficeGraph > Applicable: Exchange Online @@ -5193,6 +5526,32 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RemoveComplianceTagHoldApplied + +> Applicable: Exchange Online, Exchange Online Protection + +This parameter is available only in the cloud-based service. + +The RemoveComplianceTagHoldApplied switch specifies whether to remove compliance tag holds from the mailbox. You don't need to specify a value with this switch. + +Compliance tags (also known as retention labels) can be applied to mailbox items to retain or delete content based on organizational policies. When a compliance tag with a hold action is applied, the ComplianceTagHoldApplied property is set to true to prevent the deletion of mailbox. This switch allows you to remove such holds from the mailbox. + +By default, you can only remove compliance tag holds from inactive mailboxes. To remove compliance tag holds from active mailboxes, you must also use the ProvideConsent switch to acknowledge that you understand the implications of removing the hold. + +For more information about compliance tags and retention, see [Learn about retention policies and retention labels](https://learn.microsoft.com/purview/retention). + +```yaml +Type: SwitchParameter +Parameter Sets: RemoveComplianceTagHoldApplied +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -RemoveDelayHoldApplied > Applicable: Exchange Online, Exchange Online Protection