New-InboxRule
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 New-InboxRule cmdlet 在邮箱中创建收件箱规则。 收件箱规则根据条件处理收件箱中的邮件，并执行诸如将邮件移动到指定文件夹或删除邮件等操作。
您必须对邮箱具有足够的权限才能为其创建收件箱规则。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
New-InboxRule
[-Name] <String>
[-AlwaysDeleteOutlookRulesBlob]
[-ApplyCategory <MultiValuedProperty>]
[-ApplySystemCategory <MultiValuedProperty>]
[-BodyContainsWords <MultiValuedProperty>]
[-Confirm]
[-CopyToFolder <MailboxFolderIdParameter>]
[-DeleteMessage <Boolean>]
[-DeleteSystemCategory <MultiValuedProperty>]
[-DomainController <Fqdn>]
[-ExceptIfBodyContainsWords <MultiValuedProperty>]
[-ExceptIfFlaggedForAction <String>]
[-ExceptIfFrom <RecipientIdParameter[]>]
[-ExceptIfFromAddressContainsWords <MultiValuedProperty>]
[-ExceptIfHasAttachment <Boolean>]
[-ExceptIfHasClassification <MessageClassificationIdParameter[]>]
[-ExceptIfHeaderContainsWords <MultiValuedProperty>]
[-ExceptIfMessageTypeMatches <InboxRuleMessageType>]
[-ExceptIfMyNameInCcBox <Boolean>]
[-ExceptIfMyNameInToBox <Boolean>]
[-ExceptIfMyNameInToOrCcBox <Boolean>]
[-ExceptIfMyNameNotInToBox <Boolean>]
[-ExceptIfReceivedAfterDate <ExDateTime>]
[-ExceptIfReceivedBeforeDate <ExDateTime>]
[-ExceptIfRecipientAddressContainsWords <MultiValuedProperty>]
[-ExceptIfSentOnlyToMe <Boolean>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSubjectContainsWords <MultiValuedProperty>]
[-ExceptIfSubjectOrBodyContainsWords <MultiValuedProperty>]
[-ExceptIfWithImportance <Importance>]
[-ExceptIfWithinSizeRangeMaximum <ByteQuantifiedSize>]
[-ExceptIfWithinSizeRangeMinimum <ByteQuantifiedSize>]
[-ExceptIfWithSensitivity <Sensitivity>]
[-FlaggedForAction <String>]
[-Force]
[-ForwardAsAttachmentTo <RecipientIdParameter[]>]
[-ForwardTo <RecipientIdParameter[]>]
[-From <RecipientIdParameter[]>]
[-FromAddressContainsWords <MultiValuedProperty>]
[-HasAttachment <Boolean>]
[-HasClassification <MessageClassificationIdParameter[]>]
[-HeaderContainsWords <MultiValuedProperty>]
[-Mailbox <MailboxIdParameter>]
[-MarkAsRead <Boolean>]
[-MarkImportance <Importance>]
[-MessageTypeMatches <InboxRuleMessageType>]
[-MoveToFolder <MailboxFolderIdParameter>]
[-MyNameInCcBox <Boolean>]
[-MyNameInToBox <Boolean>]
[-MyNameInToOrCcBox <Boolean>]
[-MyNameNotInToBox <Boolean>]
[-PinMessage <Boolean>]
[-Priority <Int32>]
[-ReceivedAfterDate <ExDateTime>]
[-ReceivedBeforeDate <ExDateTime>]
[-RecipientAddressContainsWords <MultiValuedProperty>]
[-RedirectTo <RecipientIdParameter[]>]
[-SendTextMessageNotificationTo <MultiValuedProperty>]
[-SentOnlyToMe <Boolean>]
[-SentTo <RecipientIdParameter[]>]
[-SoftDeleteMessage <Boolean>]
[-StopProcessingRules <Boolean>]
[-SubjectContainsWords <MultiValuedProperty>]
[-SubjectOrBodyContainsWords <MultiValuedProperty>]
[-WhatIf]
[-WithImportance <Importance>]
[-WithinSizeRangeMaximum <ByteQuantifiedSize>]
[-WithinSizeRangeMinimum <ByteQuantifiedSize>]
[-WithSensitivity <Sensitivity>]
[<CommonParameters>] New-InboxRule
-FromMessageId <MailboxStoreObjectIdParameter>
[-ValidateOnly]
[-AlwaysDeleteOutlookRulesBlob]
[-Confirm]
[-DomainController <Fqdn>]
[-ExceptIfFromSubscription <AggregationSubscriptionIdentity[]>]
[-Force]
[-FromSubscription <AggregationSubscriptionIdentity[]>]
[-Mailbox <MailboxIdParameter>]
[-WhatIf]
[<CommonParameters>] 说明
在 Exchange PowerShell 中创建、修改、删除、启用或禁用收件箱规则时，Microsoft Outlook 和出站规则禁用的任何客户端规则都将被删除。
用于表示条件的参数还具有相应的例外参数。 如果邮件匹配例外中指定的条件，则不会对其应用此规则。 例外参数以 ExceptIf 开头。 例如，SubjectOrBodyContainsWords 的例外参数是 ExceptIfSubjectOrBodyContainsWords。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-InboxRule "CheckActionRequired" -MyNameInToBox $true -FlaggedForAction Any -MarkImportance "High"本示例在邮箱所有者位于“收件人”字段中时将邮件重要性提升为 High。 此外，还对邮件进行标记以便后续操作。
参数
-AlwaysDeleteOutlookRulesBlob
使用以前称为 Outlook Web App) 或 Exchange PowerShell 的 Outlook 网页版 (修改收件箱规则时，AlwaysDeleteOutlookRulesBlob 开关会隐藏警告消息。 不必为此开关指定值。
| 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, Exchange Online |
-ApplyCategory
ApplyCategory 参数指定对邮件应用指定类别的收件箱规则的操作。 有效值是要定义为类别的任何文本值。 可以指定用逗号分隔的多个类别。 如果值中有空格，请使用双引号 (") 将此值括起来。
为此参数指定的类别在邮箱中定义， (它们不会在) 邮箱之间共享。
| Type: | MultiValuedProperty |
| 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 |
-ApplySystemCategory
ApplySystemCategory 参数指定对邮件应用指定系统类别的收件箱规则的操作。 系统类别可用于组织中的所有邮箱。 有效值包含:
- 未定义
- 条例 草案
- 文档
- DocumentPlus
- Event
- 系列
- 文件
- 飞行
- FromContact
- 重要
- LiveView
- 住宿
- MailingList
- 通讯
- Photo
- 购买
- RentalCar
- RestaurantReservation
- RetiredPromotion
- ShippingNotification
- 购物
- SocialUpdate
- 旅行
- 视频
可以指定用逗号分隔的多个值。
| Type: | MultiValuedProperty |
| 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 |
-BodyContainsWords
BodyContainsWords 参数指定收件箱规则的条件，该规则在邮件正文中查找指定的字词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此条件的相应异常参数是 ExceptIfBodyContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-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 |
-CopyToFolder
CopyToFolder 参数指定将邮件复制到指定邮箱文件夹的收件箱规则的操作。 语法为 MailboxID:\ParentFolder[\SubFolder]。
对于 的值 MailboxID，可以使用唯一标识邮箱的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
此参数 john@contoso.com:\Marketing 的示例值为 或 John:\Inbox\Reports。
| Type: | MailboxFolderIdParameter |
| 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 |
-DeleteMessage
DeleteMessage 参数指定将邮件发送到“已删除邮件”文件夹的收件箱规则的操作。 有效值包含:
- $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, Exchange Online |
-DeleteSystemCategory
DeleteSystemCategory 参数指定收件箱规则的操作，该操作从邮件中删除指定的系统类别。 系统类别可用于组织中的所有邮箱。 有效值包含:
- 未定义
- 条例 草案
- 文档
- DocumentPlus
- Event
- 系列
- 文件
- 飞行
- FromContact
- 重要
- LiveView
- 住宿
- MailingList
- 通讯
- Photo
- 购买
- RentalCar
- RestaurantReservation
- RetiredPromotion
- ShippingNotification
- 购物
- SocialUpdate
- 旅行
- 视频
可以指定用逗号分隔的多个值。
| Type: | MultiValuedProperty |
| 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExceptIfBodyContainsWords
ExceptIfBodyContainsWords 参数指定收件箱规则的例外，该规则在邮件正文中查找指定的字词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此异常的相应条件参数是 BodyContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-ExceptIfFlaggedForAction
ExceptIfFlaggedForAction 参数为“收件箱”规则指定一个例外，该规则查找具有指定邮件标志的邮件。 有效值包含:
- 任何
- 呼叫
- DoNotForward
- 随访
- ForYourInformation
- 转发
- NoResponseNecessary
- 读取
- 答复
- ReplyToAll
- 审阅
此异常的相应条件参数为 FlaggedForAction。
| Type: | String |
| 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 |
-ExceptIfFrom
ExceptIfFrom 参数指定在邮件中查找指定发件人的收件箱规则的例外。 可以使用唯一标识该发件人的任何值。 例如：例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
此异常的相应条件参数为 From。
| Type: | RecipientIdParameter[] |
| 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 |
-ExceptIfFromAddressContainsWords
ExceptIfFromAddressContainsWords 参数指定收件箱规则的例外，该规则用于查找发件人电子邮件地址中指定字词的邮件。
可以指定用逗号分隔的多个值。
此异常的相应条件参数是 FromAddressContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-ExceptIfHasAttachment
ExceptIfHasAttachment 参数为“收件箱”规则指定一个例外，该规则用于查找带有附件的邮件。 有效值包含:
- $true：规则操作不应用于具有附件的邮件。
- $false：不使用异常。
此异常的相应条件参数为 HasAttachment。
| 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, Exchange Online |
-ExceptIfHasClassification
ExceptIfHasClassification 参数指定收件箱规则的例外，该规则查找具有指定邮件分类的邮件。 可以使用 Get-MessageClassification cmdlet 查找消息分类。 可以指定用逗号分隔的多个消息分类。
此异常的相应条件参数为 HasClassification。
| Type: | MessageClassificationIdParameter[] |
| 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 |
-ExceptIfHeaderContainsWords
HeaderContainsWords 参数指定收件箱规则的例外，该规则在邮件的标头字段中查找指定的字词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此异常的相应条件参数是 HeaderContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-ExceptIfMessageTypeMatches
ExceptIfMessageTypeMatches 参数为“收件箱”规则指定一个例外，该规则查找指定类型的邮件。 有效值包含:
- AutomaticReply
- AutomaticForward
- 已加密
- 日历
- CalendaringResponse
- PermissionControlled
- 语音邮件
- Signed
- ApprovalRequest
- ReadReceipt
- NonDeliveryReport
此异常的相应条件参数为 MessageTypeMatches。
| Type: | InboxRuleMessageType |
| 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 |
-ExceptIfMyNameInCcBox
ExceptIfMyNameInCcBox 参数指定收件箱规则的例外，该规则查找邮箱所有者位于“抄送”字段中的邮件。 有效值包含:
- $true：规则操作不会应用于邮箱所有者位于抄送字段中的邮件。
- $false：不使用异常。
此异常的相应条件参数是 MyNameInCcBox。
| 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, Exchange Online |
-ExceptIfMyNameInToBox
ExceptIfMyNameInToBox 参数指定收件箱规则的例外，该规则查找邮箱所有者位于“收件人”字段中的邮件。 有效值包含:
- $true：规则操作不会应用于邮箱所有者位于“收件人”字段中的邮件。
- $false：不使用异常。
此异常的相应条件参数是 MyNameInToBox。
| 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, Exchange Online |
-ExceptIfMyNameInToOrCcBox
ExceptIfMyNameInToOrCcBox 参数指定收件箱规则的例外，该规则在“收件人”或“抄送”字段中查找邮箱所有者位于“收件人”或“抄送”字段中的邮件有效值。
- $true：规则操作不会应用于邮箱所有者位于“收件人”或“抄送”字段中的邮件。
- $false：不使用异常。
此异常的相应条件参数是 MyNameInToOrCcBox。
| 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, Exchange Online |
-ExceptIfMyNameNotInToBox
ExceptIfMyNameNotInToBox 参数指定收件箱规则的例外，该规则查找邮箱所有者不在“收件人”字段中的邮件。 有效值包含:
- $true：规则操作不会应用于邮箱所有者不在“收件人”字段中的邮件。
- $false：不使用异常。
此异常的相应条件参数是 MyNameNotInToBox。
| 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, Exchange Online |
-ExceptIfReceivedAfterDate
ExceptIfReceivedAfterDate 参数指定收件箱规则的例外，该规则查找在指定日期之后收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此异常的相应条件参数为 ReceivedAfterDate。
| Type: | ExDateTime |
| 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 |
-ExceptIfReceivedBeforeDate
ExceptIfReceivedBeforeDate 参数指定收件箱规则的例外，该规则查找在指定日期之前收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此异常的相应条件参数为 ReceivedBeforeDate。
| Type: | ExDateTime |
| 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 |
-ExceptIfRecipientAddressContainsWords
ExceptIfRecipientAddressContainsWords 参数指定收件箱规则的例外，该规则在收件人电子邮件地址中查找指定字词的邮件。
可以指定用逗号分隔的多个值。
此异常的相应条件参数是 RecipientAddressContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-ExceptIfSentOnlyToMe
ExceptIfSentOnlyToMe 参数指定收件箱规则的例外，该规则查找只有收件人是邮箱所有者的邮件。 有效值包含:
- $true：规则操作不会应用于邮箱所有者是唯一收件人的邮件。
- $false：不使用异常。
此异常的相应条件参数为 SentOnlyToMe。
| 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, Exchange Online |
-ExceptIfSentTo
ExceptIfSentTo 参数指定在邮件中查找收件人的异常。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
此异常的相应条件参数为 SentTo。
| Type: | RecipientIdParameter[] |
| 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 |
-ExceptIfSubjectContainsWords
ExceptIfSubjectContainsWords 参数指定收件箱规则的例外，该规则在邮件的“主题”字段中查找指定的字词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此异常的相应条件参数是 SubjectContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-ExceptIfSubjectOrBodyContainsWords
ExceptIfSubjectOrBodyContainsWords 参数指定收件箱规则的例外，该规则在邮件的“主题”字段或正文中查找指定的单词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此异常的相应条件参数是 ExceptIfSubjectOrBodyContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-ExceptIfWithImportance
ExceptIfWithImportance 参数指定收件箱规则的例外，该规则查找具有指定重要性级别的邮件。 有效值包含:
- 高
- 一般
- 低
此异常的相应条件参数为 WithImportance。
| Type: | Importance |
| 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 |
-ExceptIfWithinSizeRangeMaximum
ExceptIfWithinSizeRangeMaximum 参数指定收件箱规则的一部分例外，该规则查找小于指定最大大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB (TB)
TB（兆兆字节）
你需要将此参数与 ExceptIfWithinSizeRangeMinimum 参数一起使用，并且此参数的值必须大于 ExceptIfWithinSizeRangeMinimum 的值。
此异常的相应条件参数为 WithinSizeRangeMaximum。
| Type: | ByteQuantifiedSize |
| 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 |
-ExceptIfWithinSizeRangeMinimum
ExceptIfWithinSizeRangeMinimum 参数指定收件箱规则的一部分例外，该规则查找大于指定最小大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB (TB)
TB（兆兆字节）
需要将此参数与 ExceptIfWithinSizeRangeMaximum 参数一起使用，并且此参数的值必须小于 ExceptIfWithinSizeRangeMaximum 的值。
此异常的相应条件参数为 WithinSizeRangeMinimum。
| Type: | ByteQuantifiedSize |
| 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 |
-ExceptIfWithSensitivity
ExceptIfWithSensitivity 参数指定收件箱规则的例外，该规则查找具有指定敏感度级别的邮件。 有效值包含:
- 一般
- 个人
- 私人
- CompanyConfidential
此异常的相应条件参数为 WithSensitivity。
| Type: | Sensitivity |
| 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 |
-FlaggedForAction
FlaggedForAction 参数指定收件箱规则的条件，该规则查找具有指定邮件标志的邮件。 有效值包含:
- 任何
- 呼叫
- DoNotForward
- 随访
- ForYourInformation
- 转发
- NoResponseNecessary
- 读取
- 答复
- ReplyToAll
- 审阅
| Type: | String |
| 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 |
-Force
强制开关隐藏警告或确认消息。 不必为此开关指定值。
如果邮箱包含由 Outlook 创建的规则，则确认提示会发出警告，因为此 cmdlet 的操作将删除任何客户端规则。
| 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, Exchange Online |
-ForwardAsAttachmentTo
ForwardAsAttachmentTo 参数指定收件箱规则的操作，该操作将邮件作为附件转发给指定的收件人。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
| Type: | RecipientIdParameter[] |
| 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 |
-ForwardTo
ForwardTo 参数指定将邮件转发给指定收件人的收件箱规则的操作。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
| Type: | RecipientIdParameter[] |
| 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 |
-From
From 参数指定收件箱规则的条件，该规则在邮件中查找指定的发件人。 可以使用唯一标识该发件人的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
此条件的相应异常参数为 ExceptIfFrom。
| Type: | RecipientIdParameter[] |
| 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 |
-FromAddressContainsWords
FromAddressContainsWords 参数指定收件箱规则的条件，用于查找发件人电子邮件地址中指定字词的邮件。
可以指定用逗号分隔的多个值。
此条件的相应异常参数是 ExceptIfFromAddressContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-FromMessageId
FromMessageId 参数指定用于创建收件箱规则的邮件。 规则基于消息的属性。 可以通过该消息的 Base64 编码 StoreObjectId 属性值来标识消息。 例如：
- MailboxId\StoreObjectId
- StoreObjectId
使用此参数创建收件箱规则时，规则中将使用以下邮件属性：
- 主题：邮件主题将添加到 SubjectContainsWords 条件中。
- 发件人：将邮件发件人添加到“发件人”条件。
- 收件人和抄送：“收件人”和“抄送”字段中的收件人将添加到 SentTo 条件中。
| Type: | MailboxStoreObjectIdParameter |
| 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, Exchange Online |
-HasAttachment
HasAttachment 参数指定“收件箱”规则的条件，该规则用于查找带有附件的邮件。 有效值包含:
- $true：规则操作应用于具有附件的邮件。
- $false：不使用条件。
此条件的相应异常参数为 ExceptIfHasAttachment。
| 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, Exchange Online |
-HasClassification
HasClassification 参数指定收件箱规则的条件，该规则查找具有指定邮件分类的邮件。 可以使用 Get-MessageClassification cmdlet 查找消息分类。 可以指定用逗号分隔的多个消息分类。
此条件的相应异常参数为 ExceptIfHasClassification。
| Type: | MessageClassificationIdParameter[] |
| 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 |
-HeaderContainsWords
HeaderContainsWords 参数指定收件箱规则的条件，该规则在邮件的标头字段中查找指定的字词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此条件的相应异常参数为 ExceptIfHeaderContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MarkAsRead
MarkAsRead 参数指定将邮件标记为已读的收件箱规则的操作。 有效值包含:
- $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, Exchange Online |
-MarkImportance
MarkImportance 参数为“收件箱”规则指定一个操作，该规则使用指定的重要性标志标记邮件。 有效值包含:
- 低
- 一般
- 高
| Type: | Importance |
| 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 |
-MessageTypeMatches
MessageTypeMatches 参数指定收件箱规则的条件，该规则查找指定类型的邮件。 有效值包含:
- AutomaticReply
- AutomaticForward
- 已加密
- 日历
- CalendaringResponse
- PermissionControlled
- 语音邮件
- Signed
- ApprovalRequest
- ReadReceipt
- NonDeliveryReport
此条件的相应异常参数为 ExceptIfMessageTypeMatches。
| Type: | InboxRuleMessageType |
| 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 |
-MoveToFolder
MoveToFolder 参数指定将邮件移动到指定邮箱文件夹的收件箱规则的操作。 语法为 MailboxID:\ParentFolder[\SubFolder]。
对于 的值 MailboxID，可以使用唯一标识邮箱的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
此参数 john@contoso.com:\Marketing 的示例值为 或 John:\Inbox\Reports。
| Type: | MailboxFolderIdParameter |
| 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 |
-MyNameInCcBox
MyNameInCcBox 参数指定收件箱规则的条件，用于查找邮箱所有者位于“抄送”字段中的邮件。 有效值包含:
- $true：规则操作应用于邮箱所有者位于抄送字段中的邮件。
- $false：不使用条件。
此条件的相应异常参数为 ExceptIfMyNameInCcBox。
| 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, Exchange Online |
-MyNameInToBox
MyNameInToBox 参数指定收件箱规则的条件，该规则查找邮箱所有者位于“收件人”字段中的邮件。 有效值包含:
- $true：规则操作应用于邮箱所有者位于“收件人”字段中的邮件。
- $false：不使用条件。
此条件的相应异常参数为 ExceptIfMyNameInToBox。
| 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, Exchange Online |
-MyNameInToOrCcBox
MyNameInToOrCcBox 参数指定收件箱规则的条件，该规则查找邮箱所有者位于“收件人”或“抄送”字段中的邮件有效值。
- $true：规则操作应用于邮箱所有者位于“收件人”或“抄送”字段中的邮件。
- $false：不使用条件。
此条件的相应异常参数为 ExceptIfMyNameInToOrCcBox。
| 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, Exchange Online |
-MyNameNotInToBox
MyNameNotInToBox 参数指定收件箱规则的条件，用于查找邮箱所有者不在“收件人”字段中的邮件。 有效值包含:
- $true：规则操作应用于邮箱所有者不在“收件人”字段中的邮件。
- $false：不使用条件。
此条件的相应异常参数为 ExceptIfMyNameNotInToBox。
| 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, Exchange Online |
-Name
Name 参数指定收件箱规则的名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | 1 |
| 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, Exchange Online |
-PinMessage
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 |
-Priority
Priority 参数指定确定规则处理顺序的收件箱规则的优先级。 整数值越小，表示优先级越高，
| Type: | Int32 |
| 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 |
-ReceivedAfterDate
ReceivedAfterDate 参数指定收件箱规则的条件，该规则查找在指定日期之后收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此条件的相应异常参数为 ExceptIfReceivedAfterDate。
| Type: | ExDateTime |
| 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 |
-ReceivedBeforeDate
ReceivedBeforeDate 参数指定收件箱规则的条件，用于查找在指定日期之前收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此条件的相应异常参数为 ExceptIfReceivedBeforeDate。
| Type: | ExDateTime |
| 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 |
-RecipientAddressContainsWords
RecipientAddressContainsWords 参数指定收件箱规则的条件，该规则用于查找收件人电子邮件地址中指定字词的邮件。
可以指定用逗号分隔的多个值。
此条件的相应异常参数是 ExceptIfRecipientAddressContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-RedirectTo
RedirectTo 参数指定将邮件重定向到指定收件人的收件箱规则的操作。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
| Type: | RecipientIdParameter[] |
| 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 |
-SendTextMessageNotificationTo
此参数只在本地 Exchange 中可用。
SendTextMessageNotificationTo 参数指定收件箱规则的操作，该操作将短信通知发送到指定的电话号码。
可以指定用逗号分隔的多个值。
| Type: | MultiValuedProperty |
| 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 |
-SentOnlyToMe
SentOnlyToMe 参数指定收件箱规则的条件，该规则查找只有收件人是邮箱所有者的邮件。 有效值包含:
- $true：规则操作应用于邮箱所有者是唯一收件人的邮件。
- $false：不使用条件。
此条件的相应异常参数为 ExceptIfSentOnlyToMe。
| 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, Exchange Online |
-SentTo
SentTo 参数指定收件箱规则的条件，该规则查找具有指定收件人的邮件。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
此条件的相应异常参数为 ExceptIfSentTo。
| Type: | RecipientIdParameter[] |
| 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 |
-SoftDeleteMessage
此参数仅在基于云的服务中可用。
{{ Fill SoftDeleteMessage Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-StopProcessingRules
StopProcessingRules 参数为收件箱规则指定一个操作，该操作在满足此收件箱规则的条件时停止处理其他规则。 有效值为：如果设置为 $true，则 StopProcessingRules 参数指示 Exchange 在满足此收件箱规则的条件时停止处理其他规则。
- $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, Exchange Online |
-SubjectContainsWords
SubjectContainsWords 参数指定收件箱规则的条件，该规则在邮件的“主题”字段中查找指定的字词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此条件的相应异常参数为 ExceptIfSubjectContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-SubjectOrBodyContainsWords
SubjectOrBodyContainsWords 参数指定收件箱规则的条件，该规则在邮件的“主题”字段或正文中查找指定的字词或短语。
如果短语包含空格，则需要将值括在引号中。 可以指定用逗号分隔的多个值。
此条件的相应异常参数是 ExceptIfSubjectOrBodyContainsWords。
| Type: | MultiValuedProperty |
| 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 |
-ValidateOnly
ValidateOnly 开关指示此 cmdlet 评估执行相应操作所必须满足的条件和要求，然后报告相应操作是否成功。 如果你使用的是 ValidateOnly 开关，则不会有任何变化。
| Type: | SwitchParameter |
| 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, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WithImportance
WithImportance 参数指定收件箱规则的条件，该规则查找具有指定重要性级别的邮件。 有效值包含:
- 高
- 一般
- 低
此条件的相应异常参数为 ExceptIfWithImportance。
| Type: | Importance |
| 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 |
-WithinSizeRangeMaximum
WithinSizeRangeMaximum 参数指定收件箱规则条件的一部分，用于查找小于指定最大大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB (TB)
TB（兆兆字节）
你需要将此参数与 WithinSizeRangeMinimum 参数一起使用，并且此参数的值必须大于 WithinSizeRangeMinimum 的值。
此条件的相应异常参数是 ExceptIfWithinSizeRangeMaximum。
| Type: | ByteQuantifiedSize |
| 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 |
-WithinSizeRangeMinimum
WithinSizeRangeMinimum 参数指定收件箱规则条件的一部分，该规则查找大于指定最小大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB (TB)
TB（兆兆字节）
你需要将此参数与 WithinSizeRangeMaximum 参数一起使用，并且此参数的值必须小于 WithinSizeRangeMaximum 的值。
此条件的相应异常参数是 ExceptIfWithinSizeRangeMinimum。
| Type: | ByteQuantifiedSize |
| 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 |
-WithSensitivity
WithSensitivity 参数指定收件箱规则的条件，该规则查找具有指定敏感度级别的邮件。 有效值包含:
- 一般
- 个人
- 私人
- CompanyConfidential
此条件的相应异常参数为 ExceptIfWithSensitivity。
| Type: | Sensitivity |
| 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 不返回任何数据。