Set-RecipientFilterConfig
适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题: 2009-05-18
使用 Set-RecipientFilterConfig cmdlet 可以在安装了边缘传输服务器角色或集线器传输服务器角色的计算机上启用和配置收件人筛选器代理。
语法
Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]
详细说明
若要运行 Set-RecipientFilterConfig cmdlet,必须为您使用的帐户委派以下角色:
- Exchange Server 管理员角色和目标服务器的本地 Administrators 组
若要在安装了边缘传输服务器角色的计算机上运行 Set-RecipientFilterConfig cmdlet,必须使用作为该计算机上的本地 Administrators 组成员的帐户进行登录。
有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项。
参数
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
BlockedRecipients |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
BlockedRecipients 参数的有效输入是一个或多个 SMTP 地址。最多可以为 BlockedRecipients 参数输入 800 个 SMTP 地址。 |
BlockListEnabled |
可选 |
System.Boolean |
BlockListEnabled 参数的有效输入是 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。已安装边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。 |
Enabled |
可选 |
System.Boolean |
Enabled 参数的有效输入是 |
ExternalMailEnabled |
可选 |
System.Boolean |
ExternalMailEnabled 参数的有效输入是 |
Instance |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig |
使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。 |
InternalMailEnabled |
可选 |
System.Boolean |
InternalMailEnabled 参数的有效输入是 |
RecipientValidationEnabled |
可选 |
System.Boolean |
RecipientValidationEnabled 参数的有效输入是 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
|
示例
以下代码示例显示两个 Set-RecipientFilterConfig 命令。
第一个代码示例显示如何修改收件人筛选器的配置,以便启用收件人验证。
第二个代码示例说明了如何启用阻止收件人列表以及如何向阻止收件人列表中添加收件人。
BlockedRecipients 参数接受多个值。如果将某个值传递给 BlockedRecipients 参数,现有值将替换为新值。有关在多值属性中添加或删除值的详细信息,请参阅修改多值属性。
Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com