Remove-Mailbox
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Remove-Mailbox cmdlet 可以删除邮箱和相关的用户帐户。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Remove-Mailbox
[-Identity] <MailboxIdParameter>
[-Permanent <Boolean>]
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-IgnoreDefaultScope]
[-IgnoreLegalHold]
[-Migration]
[-PublicFolder]
[-RemoveArbitrationMailboxWithOABsAllowed]
[-RemoveLastArbitrationMailboxAllowed]
[-SupervisoryReviewPolicy]
[-WhatIf]
[<CommonParameters>]
Remove-Mailbox
-Database <DatabaseIdParameter>
-StoreMailboxIdentity <StoreMailboxIdParameter>
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-IgnoreDefaultScope]
[-IgnoreLegalHold]
[-Migration]
[-PublicFolder]
[-RemoveArbitrationMailboxWithOABsAllowed]
[-RemoveLastArbitrationMailboxAllowed]
[-SupervisoryReviewPolicy]
[-WhatIf]
[<CommonParameters>]
Remove-Mailbox
[-Identity] <MailboxIdParameter>
[-PermanentlyDelete]
[-Confirm]
[-Force]
[-Migration]
[-PublicFolder]
[-RemoveCNFPublicFolderMailboxPermanently]
[-WhatIf]
[<CommonParameters>]
说明
单独使用 Identity 参数可以将邮箱与用户断开,删除该用户帐户。 邮箱仍然存在,并且会保留到已删除邮箱的保留期到期为止。 如果 UseDatabaseRetentionDefaults 属性为 False,则删除的邮箱保留期由邮箱数据库或邮箱本身的 MailboxRetention 属性控制。
使用 Identity 和 Permanent 参数可以将邮箱与用户断开,并删除该用户帐户,然后立即从邮箱数据库中删除该邮箱。 邮箱不会作为断开的邮箱保留在邮箱数据库中。
使用 Disable-Mailbox cmdlet 可以将邮箱与用户帐户断开,但保留用户帐户。 邮箱将一直保留到数据库或邮箱的已删除邮箱的保留期过期为止,然后该邮箱将永久被删除(清除)。 或者,可以使用 Remove-Mailbox cmdlet 上的 Database 和 StoreMailboxIdentity 参数立即清除断开连接的邮箱。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Remove-Mailbox -Identity "John Rodman"
本示例将删除名为 John Rodman 的用户的邮箱和用户帐户。 将按照对该数据库配置的已删除邮箱的保留期,将该邮箱在邮箱数据库中保留一段时间。
示例 2
Remove-Mailbox -Identity "John Rodman" -Permanent $true
在本地 Exchange 中,此示例删除名为 John Rodman 的用户的邮箱和用户帐户。 邮箱将立即并永久地从邮箱数据库中删除。
示例 3
$Temp = Get-Mailbox | Where {$_.DisplayName -eq 'John Rodman'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid
在本地 Exchange 中,此示例在邮箱与用户帐户断开连接后,从邮箱数据库中删除 John Rodman 的邮箱。 本示例使用 Get-Mailbox cmdlet 检索已断开邮箱的邮箱 GUID 值,StoreMailboxIdentity 参数需要该值。
示例 4
Get-Mailbox -Identity Laura -SoftDeletedMailbox | Remove-Mailbox -PermanentlyDelete
在 Exchange Online,此示例删除指定的软删除邮箱。
参数
-Arbitration
此参数只在本地 Exchange 中可用。
需要仲裁开关才能删除仲裁邮箱。 不必为此开关指定值。
仲裁邮箱是用于存储不同类型的系统数据和管理邮件审批工作流的系统邮箱。
若要删除用于存储审核日志设置或数据的仲裁邮箱,请不要使用此开关。 请改用 AuditLog 或 AuxAuditLog 开关。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AuditLog
此参数只在本地 Exchange 中可用。
需要 AuditLog 开关才能删除审核日志邮箱。 不必为此开关指定值。
审核日志邮箱是用于存储审核日志设置的仲裁邮箱。
若要删除其他类型的仲裁邮箱,请不要使用此开关。 请改用仲裁开关。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-AuxAuditLog
此参数只在本地 Exchange 中可用。
需要 AuxAuditLog 开关才能删除辅助审核日志邮箱。 不必为此开关指定值。
审核日志邮箱是用于存储审核日志设置的仲裁邮箱。
若要删除其他类型的仲裁邮箱,请不要使用此开关。 请改用仲裁开关。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false
。 - 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Database
此参数只在本地 Exchange 中可用。
Database 参数指定包含要删除的邮箱的 Exchange 数据库。 可以使用任何能够唯一标识此数据库的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
当您使用此参数和 StoreMailboxIdentity 参数识别和删除邮箱时,邮箱将立即从该数据库永久删除,因此无法重新连接或还原该邮箱。 您不能将这两个参数与 Identity 参数一起使用。
如果已断开邮箱与其关联用户的连接,并且想要从 Exchange 存储中删除邮箱对象,请使用 Database 和 StoreMailboxIdentity 参数。
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
强制开关隐藏警告或确认消息。 不必为此开关指定值。
您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity 参数标识要删除的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
此参数不能与 Database 参数一起使用。
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IgnoreDefaultScope
此参数只在本地 Exchange 中可用。
IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置,并将整个林用作范围。 不必为此开关指定值。
此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象,但也引入了以下限制:
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IgnoreLegalHold
此参数只在本地 Exchange 中可用。
IgnoreLegalHold 开关忽略用户的法定保留状态。 不必为此开关指定值。
禁用或删除用户时,用户处于法定保留状态的基于云的邮箱也会被禁用或删除。
禁用或删除邮箱后,无法将其包含在发现搜索中。 在禁用某个邮箱时,该邮箱会从用户帐户断开连接。 断开连接的邮箱和已删除的邮箱将在已删除邮箱保留期到期后从邮箱数据库永久删除。 但是,还可以删除邮箱并立即从邮箱数据库清除它。 在禁用或删除处于法定保留状态的邮箱之前,请咨询组织的法律或人力资源部门。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Migration
删除迁移邮箱需要迁移开关。 不必为此开关指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Permanent
此参数只在本地 Exchange 中可用。
Permanent 参数指定是否从邮箱数据库中永久删除邮箱。 有效值包含:
- $true:将立即永久删除邮箱, (清除) 。 无法重新连接或还原邮箱。
- $false:邮箱已禁用并保留,直到已删除邮箱保留期到期。 可以重新连接或还原邮箱,直到已删除邮箱的保留期到期。 此值为默认值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PermanentlyDelete
此参数仅在基于云的服务中可用。
PermanentlyDelete 开关会立即永久删除邮箱) 清除 (,从而阻止你恢复或还原邮箱。 不必为此开关指定值。
注意:
- 此开关仅适用于已删除但仍可恢复的邮箱, (称为软删除邮箱) 。 使用 Get-Mailbox cmdlet 标识软删除的邮箱,然后将结果通过管道传送到 Remove-Mailbox cmdlet,如本主题中的示例 4 所示。
- 此开关不适用于In-Place保留或诉讼保留 (称为非活动邮箱) 的软删除邮箱。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PublicFolder
需要 PublicFolder 开关才能删除公用文件夹邮箱。 不必为此开关指定值。
公用文件夹邮箱是专门用于存储公用文件夹的层次结构和内容的邮箱。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoveArbitrationMailboxWithOABsAllowed
此参数只在本地 Exchange 中可用。
RemoveArbitrationMailboxWithOABsAllowed 开关指定是否要在已删除的指定仲裁邮箱内绕过对脱机通讯簿 (OAB) 的检查。 不必为此开关指定值。
使用此开关时,即使 OAB 存在于该邮箱中,也会删除该仲裁邮箱。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RemoveCNFPublicFolderMailboxPermanently
此参数仅在基于云的服务中可用。
{{ Fill RemoveCNFPublicFolderMailboxPermanently Description }}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-RemoveLastArbitrationMailboxAllowed
此参数只在本地 Exchange 中可用。
RemoveLastArbitrationMailboxAllowed 开关指定如果指定的邮箱是组织中最后一个仲裁邮箱则是否删除该邮箱。 不必为此开关指定值。
如果删除组织中最后一个仲裁邮箱,则会失去用户创建的通讯组或仲裁收件人。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StoreMailboxIdentity
此参数只在本地 Exchange 中可用。
StoreMailboxIdentity 参数指定要删除的邮箱。 使用此参数时,可以通过邮箱的 MailboxGUID 值来标识邮箱。 您可以通过使用 Get-Mailbox 或 Get-MailboxStatistics cmdlet 查找 GUID 值。
当您使用此参数和 Database 参数识别和删除邮箱时,邮箱将立即从该数据库永久删除,因此无法重新连接或还原该邮箱。 不能使用 Identity 参数中的任何一个参数。
如果已断开邮箱与其关联用户的连接,并且想要从 Exchange 存储中删除邮箱对象,请使用 Database 和 StoreMailboxIdentity 参数。
Type: | StoreMailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SupervisoryReviewPolicy
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。