Set-TenantAllowBlockListItems

模块:: ExchangePowerShell

适用于:: Exchange Online, Security & Compliance, Exchange Online Protection

此 cmdlet 仅在基于云的服务中可用。

使用 Set-TenantAllowBlockListItems cmdlet 在Microsoft Defender门户中修改租户允许/阻止列表中的条目。

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

语法

Set-TenantAllowBlockListItems
   -Ids <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [-RemoveAfter <Int32>]
   [<CommonParameters>]

Set-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [-RemoveAfter <Int32>]
   [<CommonParameters>]

说明

在大多数情况下，创建条目后，无法修改发件人、URL、文件或 IP 地址值。唯一的例外是 URL 允许用于钓鱼模拟的条目， (ListType = URL，ListSubType = AdvancedDelivery) 。有关允许 URL 进行钓鱼模拟的详细信息，请参阅为非Microsoft网络钓鱼模拟配置高级传递策略以及将电子邮件传递到 SecOps 邮箱。

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

示例

示例 1

Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()

此示例更改指定条目的到期日期。

示例 2

Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021

此示例更改指定非Microsoft钓鱼模拟 URL 的 URL 允许条目的到期日期。

参数

-Allow

“允许”开关指定修改允许项。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Block

“阻止”开关指定修改块项。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Entries

Entries 参数根据 ListType 参数值指定要修改的条目。有效值包含:

FileHash：确切的 SHA256 文件哈希值。
发件人域和电子邮件地址：确切的域或电子邮件地址值。
Url：确切的 URL 值。
IP：仅限 IPv6 地址。采用冒号十六进制或零压缩格式或 CIDR IPv6 的单个 IPv6 地址范围为 1 到 128。

此值显示在 Get-TenantAllowBlockListItems cmdlet 输出中条目的 Value 属性中。

不能将值类型 (发送方、URL、文件或 IP 地址混合) ，也不能在同一命令中允许和阻止作。

不能将此参数与 Ids 参数一起使用。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ExpirationDate

ExpirationDate 参数按协调世界时 (UTC) 中的到期日期筛选结果。

若要指定此参数的日期/时间值，请使用下列方法之一：

以 UTC 格式指定日期/时间值：例如 "2021-05-06 14:30:00z"。
将日期/时间值指定为将本地时区中的日期/时间转换为 UTC 的公式：例如 (Get-Date "5/6/2020 9:30 AM").ToUniversalTime()。有关详细信息，请参阅 Get-Date。

不能将此参数与 NoExpiration 或 RemoveAfter 参数一起使用。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Ids

Ids 参数指定要修改的条目。此值显示在 Get-TenantAllowBlockListItems cmdlet 输出中的 Identity 属性中。

此参数 RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0的示例值为。

不能将此参数与 Entries 参数一起使用。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ListSubType

ListSubType 参数进一步指定要修改的条目。有效值包含:

AdvancedDelivery：将此值用于钓鱼模拟 URL。有关详细信息，请参阅配置针对非Microsoft网络钓鱼模拟的高级传递策略和将电子邮件传递到 SecOps 邮箱。
租户：这是默认值。

类型:	ListSubType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ListType

ListType 参数指定要修改的条目的类型。有效值包含:

FileHash
发件人
URL
IP

将 Entries 或 Ids 参数与此参数一起使用来标识条目本身。

类型:	ListType
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NoExpiration

NoExpiration 开关指定条目应永不过期。不必为此开关指定值。

此开关可用于以下类型的条目：

阻止条目。
URL 允许 ListSubType 参数值为 AdvancedDelivery 的条目。
IP 地址允许输入。

不能将此开关与 ExpirationDate 参数一起使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Notes

Notes 参数指定对象的其他信息。如果值中有空格，请使用双引号 (") 将此值括起来。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OutputJson

OutputJson 开关指定是否返回单个 JSON 值中的所有条目。不必为此开关指定值。

使用此开关可防止命令在包含语法错误的第一个条目上停止。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveAfter

RemoveAfter 参数为允许条目启用上次使用日期后 45 天的Remove> 功能。当筛选系统在邮件流或单击期间遇到允许条目中的错误实体时，将填充 LastUsedDate 属性。在筛选系统确定实体干净后，允许条目将保留 45 天。

此参数的唯一有效值为 45。

不能将此参数与 ExpirationDate 或 NoExpirationDate 参数一起使用。

若要将 allow 条目更改为不依赖于 LastUsedDate 属性的静态过期日期/时间值，请使用 ExpirationDate 参数运行 Set-TenantAllowBlockListItems 命令。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False