New-InboxRule
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能是一个环境或另一个环境独占。
使用 New-InboxRule cmdlet 在邮箱中创建收件箱规则。 收件箱规则根据条件处理收件箱中的邮件，并执行将邮件移动到指定文件夹或删除邮件等操作。
您必须对邮箱具有足够的权限才能为其创建收件箱规则。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Identity
New-InboxRule
[-Name] <String>
[-AlwaysDeleteOutlookRulesBlob]
[-AnyCategory <Boolean>]
[-AssignedCategories <String[]>]
[-ApplyCategory <MultiValuedProperty>]
[-ApplySystemCategory <MultiValuedProperty>]
[-BodyContainsWords <MultiValuedProperty>]
[-BulkCategory <Boolean>]
[-ClearCategories <Boolean>]
[-ClearFlag <Boolean>]
[-CompleteFlag <Boolean>]
[-Confirm]
[-CopyToFolder <MailboxFolderIdParameter>]
[-DeleteMessage <Boolean>]
[-DeleteSystemCategory <MultiValuedProperty>]
[-DisplayAlert <String>]
[-DomainController <Fqdn>]
[-ExceptIfAnyCategory <Boolean>]
[-ExceptIfAssignedCategories <String[]>]
[-ExceptIfBulkCategory <Boolean>]
[-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>]
[-FlagMessage <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>]
[-PermanentDelete <Boolean>]
[-PinMessage <Boolean>]
[-PlaySound <String>]
[-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>]
FromMessage
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 -Mailbox chris@contoso.com -Name "CheckActionRequired" -MyNameInToBox $true -FlaggedForAction Any -MarkImportance "High"
本示例在邮箱所有者位于“收件人”字段中时将邮件重要性提升为 High。 此外，还对邮件进行标记以便后续操作。
参数
-AlwaysDeleteOutlookRulesBlob
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
使用以前称为 Outlook Web App) 或 Exchange PowerShell 修改收件箱规则时Outlook 网页版 (AlwaysDeleteOutlookRulesBlob 开关会隐藏一条警告消息。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AnyCategory
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill AnyCategory Description }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ApplyCategory
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ApplyCategory 参数指定将指定类别应用于邮件的收件箱规则的操作。 有效值是要定义为类别的任何文本值。 可以指定多个类别，以逗号分隔。 如果值中有空格，请使用双引号 (") 将此值括起来。
为此参数指定的类别在邮箱中定义， (它们不会在邮箱之间共享) 。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ApplySystemCategory
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ApplySystemCategory 参数为收件箱规则指定一个操作，该操作将指定的系统类别应用于邮件。 系统类别可用于组织中的所有邮箱。 有效值包含:
- NotDefined
- 帐单
- 文档
- DocumentPlus
- 事件
- 系列
- 文件
- 外部测试版
- FromContact
- 重要
- LiveView
- 住宿
- 邮件列表
- 新闻稿
- Photo
- 购买
- RentalCar
- 餐厅预订
- RetiredPromotion
- ShippingNotification
- 购物
- SocialUpdate
- 旅行
- 视频
可以指定用逗号分隔的多个值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AssignedCategories
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill AssignedCategories Description }}
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-BodyContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
BodyContainsWords 参数指定收件箱规则的条件，该条件在邮件正文中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此条件的相应异常参数是 ExceptIfBodyContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-BulkCategory
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill BulkCategory Description }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ClearCategories
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill ClearCategories Description }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ClearFlag
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ 填充 ClearFlag 说明 }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CompleteFlag
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill CompleteFlag Description }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 有何影响取决于 cmdlet 在继续操作前是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，在不带值的情况下指定“确认”开关会引入一个暂停，从而强制你在继续之前确认命令。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CopyToFolder
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
CopyToFolder 参数指定将邮件复制到指定邮箱文件夹的收件箱规则的操作。 语法为 MailboxID:\ParentFolder[\SubFolder]。
对于 的值 MailboxID，可以使用唯一标识邮箱的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
此参数的示例值为 john@contoso.com:\Marketing OR John:\Inbox\Reports。
参数属性
| 类型: | MailboxFolderIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DeleteMessage
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
DeleteMessage 参数指定将邮件发送到“已删除邮件”文件夹的收件箱规则的操作。 有效值包含:
- $true：符合规则条件的邮件将移至“已删除邮件”文件夹。
- $false：未使用该操作。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DeleteSystemCategory
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
DeleteSystemCategory 参数指定从邮件中删除指定系统类别的收件箱规则的操作。 系统类别可用于组织中的所有邮箱。 有效值包含:
- NotDefined
- 帐单
- 文档
- DocumentPlus
- 事件
- 系列
- 文件
- 外部测试版
- FromContact
- 重要
- LiveView
- 住宿
- 邮件列表
- 新闻稿
- Photo
- 购买
- RentalCar
- 餐厅预订
- RetiredPromotion
- ShippingNotification
- 购物
- SocialUpdate
- 旅行
- 视频
可以指定用逗号分隔的多个值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DisplayAlert
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ 填充 DisplayAlert 说明 }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfAnyCategory
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ 填充 ExceptIfAnyCategory 说明 }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfAssignedCategories
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ 填充 ExceptIfAssignedCategories 说明 }}
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfBodyContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfBodyContainsWords 参数指定收件箱规则的例外，此规则在邮件正文中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此异常的相应条件参数是 BodyContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfBulkCategory
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ 填充 ExceptIfBulkCategory 说明 }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfFlaggedForAction
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfFlaggedForAction 参数为查找具有指定邮件标志的邮件的收件箱规则指定例外。 有效值包含:
- 任何
- 呼叫
- DoNotForward
- 后续
- ForYourInformation
- 转发
- NoResponseNecessary
- 阅读
- 答复
- ReplyToAll
- 审阅
此异常的相应条件参数为 FlaggedForAction。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfFrom
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfFrom 参数指定收件箱规则的例外，此规则在邮件中查找指定的发件人。 可以使用唯一标识该发件人的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
此异常的相应条件参数为 From。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfFromAddressContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfFromAddressContainsWords 参数指定收件箱规则的例外，此规则可查找指定字词在发件人的电子邮件地址中的邮件。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此异常的相应条件参数是 FromAddressContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfHasAttachment
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfHasAttachment 参数指定“收件箱规则”的例外，此规则可查找带附件的邮件。 有效值包含:
- $true：规则操作不应用于包含附件的邮件。
- $false：不使用该异常。
此异常的相应条件参数为 HasAttachment。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfHasClassification
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfHasClassification 参数指定收件箱规则的例外，此规则可查找具有指定邮件分类的邮件。 可以使用 Get-MessageClassification cmdlet 查找邮件分类。 可以指定多个邮件分类，以逗号分隔。
此异常的相应条件参数是 HasClassification。
参数属性
| 类型: | MessageClassificationIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfHeaderContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
HeaderContainsWords 参数指定收件箱规则的例外，此规则在邮件的标题字段中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此异常的相应条件参数是 HeaderContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfMessageTypeMatches
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfMessageTypeMatches 参数为查找指定类型的邮件的收件箱规则指定例外。 有效值包含:
- AutomaticReply
- AutomaticForward
- 已加密
- 日历
- CalendaringResponse
- PermissionControlled
- 语音邮件
- Signed
- ApprovalRequest
- ReadReceipt
- NonDeliveryReport
此异常的相应条件参数是 MessageTypeMatches。
参数属性
| 类型: | InboxRuleMessageType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfMyNameInCcBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfMyNameInCcBox 参数指定收件箱规则的例外，此规则可查找邮箱所有者位于“抄送”字段中的邮件。 有效值包含:
- $true： 规则操作不应用于邮箱所有者位于“抄送”字段中的邮件。
- $false：不使用该异常。
此异常的相应条件参数是 MyNameInCcBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfMyNameInToBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfMyNameInToBox 参数指定收件箱规则的例外，此规则可查找邮箱所有者位于“收件人”字段中的邮件。 有效值包含:
- $true： 规则操作不应用于邮箱所有者位于“收件人”字段中的邮件。
- $false：不使用该异常。
此异常的相应条件参数是 MyNameInToBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfMyNameInToOrCcBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfMyNameInToOrCcBox 参数指定收件箱规则的例外，此规则可查找邮箱所有者位于“收件人”或“抄送”字段中的邮件 有效值为。
- $true：规则操作不适用于邮箱所有者位于“收件人”或“抄送”字段中的邮件。
- $false：不使用该异常。
此异常的相应条件参数是 MyNameInToOrCcBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfMyNameNotInToBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfMyNameNotInToBox 参数指定收件箱规则的例外，此规则可查找邮箱所有者不在“收件人”字段中的邮件。 有效值包含:
- $true：规则操作不应用于邮箱所有者不在“收件人”字段中的邮件。
- $false：不使用该异常。
此异常的相应条件参数是 MyNameNotInToBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfReceivedAfterDate
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfReceivedAfterDate 参数指定收件箱规则的例外，此规则可查找在指定日期之后收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此异常的相应条件参数为 ReceivedAfterDate。
参数属性
| 类型: | ExDateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfReceivedBeforeDate
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfReceivedBeforeDate 参数指定收件箱规则的例外，此规则可查找在指定日期之前收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此异常的相应条件参数为 ReceivedBeforeDate。
参数属性
| 类型: | ExDateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfRecipientAddressContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfRecipientAddressContainsWords 参数指定收件箱规则的例外，此规则可查找收件人电子邮件地址中指定字词的邮件。
可以指定用逗号分隔的多个值。 此参数的最大长度是 255 个字符。
此异常的相应条件参数是 RecipientAddressContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfSentOnlyToMe
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfSentOnlyToMe 参数指定收件箱规则的例外，此规则可查找其中唯一收件人是邮箱所有者的邮件。 有效值包含:
- $true：规则操作不适用于邮箱所有者是唯一收件人的邮件。
- $false：不使用该异常。
此异常的相应条件参数是 SentOnlyToMe。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfSentTo
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfSentTo 参数指定在邮件中查找收件人的异常。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
此异常的相应条件参数为 SentTo。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfSubjectContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfSubjectContainsWords 参数指定收件箱规则的例外，此规则在邮件的“主题”字段中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此异常的相应条件参数是 SubjectContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfSubjectOrBodyContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfSubjectOrBodyContainsWords 参数指定收件箱规则的例外，此规则在邮件的“主题”字段或正文中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此异常的相应条件参数是 SubjectOrBodyContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfWithImportance
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfWithImportance 参数为查找具有指定重要级别的邮件的收件箱规则指定例外。 有效值包含:
- 高
- 一般
- 低
此异常的相应条件参数为 WithImportance。
参数属性
| 类型: | Importance |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfWithinSizeRangeMaximum
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfWithinSizeRangeMaximum 参数指定收件箱规则的例外的一部分，此规则可查找小于指定最大大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB（兆兆字节）
不限定的值通常被视为字节，但小值可能会向上舍入到最接近的千字节。
需要将此参数与 ExceptIfWithinSizeRangeMinimum 参数一起使用，并且此参数的值必须大于 ExceptIfWithinSizeRangeMinimum 的值。
此异常的相应条件参数为 WithinSizeRangeMaximum。
参数属性
| 类型: | ByteQuantifiedSize |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfWithinSizeRangeMinimum
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfWithinSizeRangeMinimum 参数指定收件箱规则的例外的一部分，此规则可查找大于指定最小大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB（兆兆字节）
不限定的值通常被视为字节，但小值可能会向上舍入到最接近的千字节。
需要将此参数与 ExceptIfWithinSizeRangeMaximum 参数一起使用，并且此参数的值必须小于 ExceptIfWithinSizeRangeMaximum 的值。
此异常的相应条件参数为 WithinSizeRangeMinimum。
参数属性
| 类型: | ByteQuantifiedSize |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExceptIfWithSensitivity
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExceptIfWithSensitivity 参数指定收件箱规则的例外，此规则可查找具有指定敏感度级别的邮件。 有效值包含:
- 一般
- 个人
- 私人
- CompanyConfidential
此异常的相应条件参数为 WithSensitivity。
参数属性
| 类型: | Sensitivity |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FlaggedForAction
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
FlaggedForAction 参数指定收件箱规则的条件，该条件可查找具有指定邮件标志的邮件。 有效值包含:
- 任何
- 呼叫
- DoNotForward
- 后续
- ForYourInformation
- 转发
- NoResponseNecessary
- 阅读
- 答复
- ReplyToAll
- 审阅
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FlagMessage
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill FlagMessage Description }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Force 开关会隐藏警告或确认消息。 不必为此开关指定值。
如果邮箱包含由 Outlook 创建的规则，则确认提示会发出警告，因为此 cmdlet 的操作删除了任何客户端规则。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ForwardAsAttachmentTo
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ForwardAsAttachmentTo 参数指定收件箱规则的操作，该操作会将邮件作为附件转发给指定收件人。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ForwardTo
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ForwardTo 参数指定收件箱规则将邮件转发给指定收件人的操作。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-From
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
“发件人”参数指定“收件箱规则”的条件，用于在邮件中查找指定的发件人。 可以使用唯一标识该发件人的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
此条件的相应异常参数是 ExceptIfFrom。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FromAddressContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
FromAddressContainsWords 参数指定收件箱规则的条件，此条件可查找指定单词在发件人的电子邮件地址中的邮件。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此条件的相应异常参数是 ExceptIfFromAddressContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FromMessageId
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
FromMessageId 参数指定用于创建收件箱规则的邮件。 该规则基于邮件的属性。 可通过 Base64 编码的 StoreObjectId 属性值来标识消息。 例如：
- MailboxId\StoreObjectId
- StoreObjectId
使用此参数创建收件箱规则时，将在规则中使用以下邮件属性：
- 主题：邮件主题添加到 SubjectContainsWords 条件。
- 发件人：邮件发件人被添加到“发件人”条件。
- “收件人”和“抄送”：“收件人”和“抄送”字段中的收件人将添加到“发送到”条件。
参数属性
| 类型: | MailboxStoreObjectIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromMessage
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-HasAttachment
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
HasAttachment 参数指定“收件箱”规则查找带附件的邮件的条件。 有效值包含:
- $true：规则操作应用于包含附件的邮件。
- $false：未使用该条件。
此条件的相应异常参数是 ExceptIfHasAttachment。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-HasClassification
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
HasClassification 参数指定收件箱规则的条件，该条件可查找具有指定邮件分类的邮件。 可以使用 Get-MessageClassification cmdlet 查找邮件分类。 可以指定多个邮件分类，以逗号分隔。
此条件的相应异常参数为 ExceptIfHasClassification。
参数属性
| 类型: | MessageClassificationIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-HeaderContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
HeaderContainsWords 参数指定收件箱规则的条件，该条件在邮件的标题字段中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此条件的相应异常参数是 ExceptIfHeaderContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Mailbox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Mailbox 参数指定包含收件箱规则的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
参数属性
| 类型: | MailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MarkAsRead
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MarkAsRead 参数为收件箱规则指定一项操作，用于将邮件标记为已读。 有效值包含:
- $true：符合规则条件的邮件标记为已读。
- $false：未使用该操作。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MarkImportance
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MarkImportance 参数指定用于标记具有指定重要性标志的邮件的收件箱规则的操作。 有效值包含:
- 低
- 一般
- 高
参数属性
| 类型: | Importance |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MessageTypeMatches
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MessageTypeMatches 参数指定“收件箱规则”的条件，用于查找指定类型的邮件。 有效值包含:
- AutomaticReply
- AutomaticForward
- 已加密
- 日历
- CalendaringResponse
- PermissionControlled
- 语音邮件
- Signed
- ApprovalRequest
- ReadReceipt
- NonDeliveryReport
此条件的相应异常参数是 ExceptIfMessageTypeMatches。
参数属性
| 类型: | InboxRuleMessageType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MoveToFolder
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MoveToFolder 参数指定将邮件移动到指定邮箱文件夹的收件箱规则的操作。 语法为 MailboxID:\ParentFolder[\SubFolder]。
对于 的值 MailboxID，可以使用唯一标识邮箱的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
此参数的示例值为 john@contoso.com:\Marketing OR John:\Inbox\Reports。
参数属性
| 类型: | MailboxFolderIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MyNameInCcBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MyNameInCcBox 参数指定收件箱规则的条件，此条件可查找“抄送”字段中邮箱所有者所在的邮件。 有效值包含:
- $true： 规则操作适用于邮箱所有者位于“抄送”字段中的邮件。
- $false：未使用该条件。
此条件的相应异常参数是 ExceptIfMyNameInCcBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MyNameInToBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MyNameInToBox 参数指定收件箱规则的条件，此条件可查找“收件人”字段中邮箱所有者所在的邮件。 有效值包含:
- $true： 规则操作应用于邮箱所有者位于“收件人”字段中的邮件。
- $false：未使用该条件。
此条件的相应异常参数是 ExceptIfMyNameInToBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MyNameInToOrCcBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MyNameInToOrCcBox 参数指定收件箱规则的条件，此条件可查找邮箱所有者位于“收件人”或“抄送”字段中的邮件： 有效值为。
- $true：规则操作适用于邮箱所有者位于“收件人”或“抄送”字段中的邮件。
- $false：未使用该条件。
此条件的相应异常参数是 ExceptIfMyNameInToOrCcBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MyNameNotInToBox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MyNameNotInToBox 参数指定收件箱规则的条件，此条件可查找邮箱所有者不在“收件人”字段中的邮件。 有效值包含:
- $true： 规则操作适用于邮箱所有者不在“收件人”字段中的邮件。
- $false：未使用该条件。
此条件的相应异常参数是 ExceptIfMyNameNotInToBox。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Name 参数指定收件箱规则的名称。 最大长度为 512 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PermanentDelete
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ 填充永久删除描述 }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PinMessage
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
PinMessage 参数为收件箱规则指定一个操作，用于将邮件固定到收件箱顶部。 有效值包含:
- $true：符合规则条件的邮件将固定到收件箱顶部。
- $false：未使用该操作。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PlaySound
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill PlaySound Description }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Priority
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
优先级参数指定收件箱规则的优先级，该规则确定规则处理顺序。 整数值越小，表示优先级越高，
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ReceivedAfterDate
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ReceivedAfterDate 参数指定收件箱规则的条件，以查找在指定日期之后收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此条件的相应异常参数为 ExceptIfReceivedAfterDate。
参数属性
| 类型: | ExDateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ReceivedBeforeDate
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ReceivedBeforeDate 参数指定收件箱规则的条件，该条件可查找在指定日期之前收到的邮件。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
此条件的相应异常参数为 ExceptIfReceivedBeforeDate。
参数属性
| 类型: | ExDateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RecipientAddressContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
RecipientAddressContainsWords 参数指定收件箱规则的条件，此条件可查找收件人电子邮件地址中指定字词的邮件。
可以指定用逗号分隔的多个值。 此参数的最大长度是 255 个字符。
此条件的相应异常参数是 ExceptIfRecipientAddressContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RedirectTo
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
RedirectTo 参数指定收件箱规则的操作，用于将邮件重定向到指定的收件人。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SendTextMessageNotificationTo
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
SendTextMessageNotificationTo 参数指定向指定电话号码发送短信通知的收件箱规则的操作。
可以指定用逗号分隔的多个值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SentOnlyToMe
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SentOnlyToMe 参数指定收件箱规则的条件，此条件可查找唯一收件人是邮箱所有者的邮件。 有效值包含:
- $true：规则操作适用于邮箱所有者是唯一收件人的邮件。
- $false：未使用该条件。
此条件的相应异常参数是 ExceptIfSentOnlyToMe。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SentTo
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SentTo 参数指定收件箱规则的条件，该条件可查找具有指定收件人的邮件。 可以使用任何能够唯一标识该收件人的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
此条件的相应异常参数是 ExceptIfSentTo。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SoftDeleteMessage
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ 填充 SoftDeleteMessage 说明 }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-StopProcessingRules
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
StopProcessingRules 参数为收件箱规则指定一个操作，如果满足此收件箱规则的条件，则停止处理其他规则。 有效值包括：如果设置为 $true，则 StopProcessingRules 参数将指示 Exchange 在满足此收件箱规则的条件时停止处理其他规则。
- $true：停止处理其他规则。
- $false：此操作不会用于 (在此) 之后继续处理更多规则。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SubjectContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SubjectContainsWords 参数指定收件箱规则的条件，该条件在邮件的“主题”字段中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此条件的相应异常参数是 ExceptIfSubjectContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SubjectOrBodyContainsWords
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SubjectOrBodyContainsWords 参数指定收件箱规则的条件，该条件在邮件的“主题”字段或正文中查找指定的字词或短语。
要指定多个字词或短语，请使用以下语法： Word1,"Phrase with spaces",word2,...wordN. 请勿使用前导或尾随空格。
此参数的最大长度是 255 个字符。
此条件的相应异常参数 ExceptIfSubjectOrBodyContainsWords。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ValidateOnly
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ValidateOnly 开关指定是在不进行更改的情况下评估命令的潜在成功还是失败。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromMessage
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WhatIf 开关显示命令执行的操作，而无需进行任何更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | WI |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WithImportance
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WithImportance 参数指定“收件箱规则”的条件，用于查找具有指定重要性级别的邮件。 有效值包含:
- 高
- 一般
- 低
此条件的相应异常参数是 ExceptIfWithImportance。
参数属性
| 类型: | Importance |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WithinSizeRangeMaximum
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WithinSizeRangeMaximum 参数指定收件箱规则的条件的一部分，此规则可查找小于指定最大大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB（兆兆字节）
不限定的值通常被视为字节，但小值可能会向上舍入到最接近的千字节。
需要将此参数与 WithinSizeRangeMinimum 参数一起使用，并且此参数的值必须大于 WithinSizeRangeMinimum 的值。
此条件的相应异常参数为 ExceptIfWithinSizeRangeMaximum。
参数属性
| 类型: | ByteQuantifiedSize |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WithinSizeRangeMinimum
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WithinSizeRangeMinimum 参数指定收件箱规则的条件的一部分，此规则可查找大于指定最小大小的邮件。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB（兆兆字节）
不限定的值通常被视为字节，但小值可能会向上舍入到最接近的千字节。
需要将此参数与 WithinSizeRangeMaximum 参数一起使用，并且此参数的值必须小于 WithinSizeRangeMaximum 的值。
此条件的相应异常参数 ExceptIfWithinSizeRangeMinimum。
参数属性
| 类型: | ByteQuantifiedSize |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WithSensitivity
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WithSensitivity 参数指定收件箱规则的条件，以查找具有指定敏感度级别的邮件。 有效值包含:
- 一般
- 个人
- 私人
- CompanyConfidential
此条件的相应异常参数是 ExceptIfWithSensitivity。
参数属性
| 类型: | Sensitivity |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持以下常用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。