New-SweepRule

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 New-SweepRule cmdlet 在邮箱中创建扫描规则。 扫描规则定期运行,以帮助保持收件箱清洁。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

New-SweepRule
   [-Name] <String>
   -Provider <String>
   [-Confirm]
   [-DestinationFolder <MailboxFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExceptIfFlagged <Boolean>]
   [-ExceptIfPinned <Boolean>]
   [-KeepForDays <Int32>]
   [-KeepLatest <Int32>]
   [-Mailbox <MailboxIdParameter>]
   [-Sender <RecipientIdParameter>]
   [-SourceFolder <MailboxFolderIdParameter>]
   [-SystemCategory <SystemCategoryType>]
   [-WhatIf]
   [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

New-SweepRule -Name "From Michelle" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender michelle@fabrikam.com -KeepLatest 1

本示例在 Felipe Apodaca 的邮箱中创建名为“From Michelle”的新扫描规则,该规则保留“ michelle@fabrikam.com 收件箱”文件夹中的最新邮件,并将旧邮件移动到“已删除邮件”文件夹。

示例 2

New-SweepRule -Name "From Lila" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender lila@fabrikam.com -KeepForDays 10

本示例在 Felipe Apodaca 的邮箱中创建名为“From Lila”的新扫描规则,该规则将 lila@fabrikam.com 超过 10 天的收件箱文件夹中的邮件移动到“已删除邮件”文件夹。

示例 3

New-SweepRule -Name "From Jeff" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender jeffm@fabrikam.com -SourceFolder "Felipe:\Sent Items" -KeepForDays 10

本示例在 Felipe Apodaca 的邮箱中创建名为“From Jeff”的新扫描规则,该规则将邮件从 jeffm@fabrikam.com “已发送邮件”文件夹中超过 10 天移动到“已删除邮件”文件夹。

参数

-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 2016, Exchange Server 2019, Exchange Online

-DestinationFolder

DestinationFolder 参数指定将邮件移动到指定文件夹的扫描规则的操作。 语法为 MailboxID:\ParentFolder[\SubFolder]

对于 的值 MailboxID,可以使用唯一标识邮箱的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

此参数 john@contoso.com:\Unimportant 的示例值为 或 John:\Inbox\Misc。 默认值为 MailboxID:\Deleted Items

Type:MailboxFolderIdParameter
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

-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 2016, Exchange Server 2019

-Enabled

Enabled 参数指定是启用或禁用扫描规则。 有效值包含:

  • $true:已启用规则。 此值为默认值。
  • $false:禁用规则。

创建规则后,可以使用 Enable-SweepRule 和 Disable-SweepRule cmdlet 启用或禁用规则。

Type:Boolean
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

-ExceptIfFlagged

ExceptIfFlagged 参数为“扫描”规则指定一个例外,该规则查找应用了邮件标志的邮件。 有效值包含:

  • $true:规则操作不会应用于应用了邮件标志的邮件。
  • $false:不使用异常。

典型的消息标志值为:

  • 任何
  • 呼叫
  • DoNotForward
  • 随访
  • ForYourInformation
  • 转发
  • NoResponseNecessary
  • 读取
  • 答复
  • ReplyToAll
  • 审阅
Type:Boolean
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

-ExceptIfPinned

PinMessage 参数指定用于查找固定邮件的扫描规则的异常。 有效值包含:

  • $true:规则操作不应用于固定到收件箱顶部的邮件。
  • $false:不使用异常。
Type:Boolean
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

-KeepForDays

KeepForDays 参数指定扫描规则的操作,该操作指定保留与规则条件匹配的邮件的天数。 经过天数后,邮件将移动到 DestinationFolder 参数指定的位置,默认情况下,“已删除邮件”文件夹 () 。

不能将此参数与 KeepLatest 参数一起使用,并且扫描规则必须包含 KeepForDays 或 KeepLatest 参数值。

Type:Int32
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

-KeepLatest

KeepLatest 参数为扫描规则指定一个操作,该操作指定要保留的与规则条件匹配的邮件数。 超过邮件数后,最早的邮件将移动到 DestinationFolder 参数指定的位置,默认情况下,“已删除邮件”文件夹 () 。

不能将此参数与 KeepForDays 参数一起使用,并且扫描规则必须包含 KeepForDays 或 KeepLatest 参数值。

Type:Int32
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

-Mailbox

Mailbox 参数指定要在其中创建扫描规则的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)
Type:MailboxIdParameter
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

-Name

Name 参数指定扫描规则的名称。 如果值包含空格,则使用引号括住该值。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Provider

Provider 参数指定扫描规则的提供程序。 如果值包含空格,则使用引号括住该值。

对于在 Outlook 网页版 中创建的扫描规则,默认值为 Exchange16。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Sender

Sender 参数指定扫描规则的条件,该规则在邮件中查找指定的发件人。 对于内部发件人,可以使用任何能够唯一标识该发件人的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

对于外部发件人,请使用其电子邮件地址。

Type:RecipientIdParameter
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

-SourceFolder

SourceFolder 参数指定扫描规则的条件,该规则查找指定文件夹中的邮件。 语法为 MailboxID:\ParentFolder[\SubFolder]

对于 的值 MailboxID,可以使用唯一标识邮箱的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

此参数 john@contoso.com:\Marketing 的示例值为 或 John:\Inbox\Reports。 默认值为 MailboxID:\Inbox

Type:MailboxFolderIdParameter
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

-SystemCategory

SystemCategory 参数指定扫描规则的条件,该规则查找具有指定系统类别的邮件。 系统类别可用于组织中的所有邮箱。 有效值包含:

  • 未定义
  • 条例 草案
  • 文档
  • DocumentPlus
  • Event
  • 系列
  • 文件
  • 飞行
  • FromContact
  • 重要
  • LiveView
  • 住宿
  • MailingList
  • 通讯
  • Photo
  • 购买
  • RentalCar
  • RestaurantReservation
  • RetiredPromotion
  • ShippingNotification
  • 购物
  • SocialUpdate
  • 旅行
  • 视频
Type:SystemCategoryType
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

-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 2016, Exchange Server 2019, Exchange Online