Set-TenantAllowBlockListItems

参考

模块:: ExchangePowerShell

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

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

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

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

语法

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

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

说明

在大多数情况下，无法修改现有条目的 URL、文件或发件人值。唯一的例外是允许网络钓鱼模拟的 URL 条目， (Action = Allow，ListType = URL，ListSubType = AdvancedDelivery) 。有关允许 URL 进行钓鱼模拟的详细信息，请参阅配置向用户传递第三方网络钓鱼模拟和将未筛选的邮件传递到 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

此示例更改指定第三方网络钓鱼模拟 URL 的 URL 允许条目的到期日期。

参数

-Allow

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Block

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Entries

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

FileHash：确切的 SHA256 文件哈希值。
发件人域和电子邮件地址：确切的域或电子邮件地址值。
Url：确切的 URL 值。

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

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ExpirationDate

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

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

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

不能将此参数用于 NoExpiration 开关。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Ids

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

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ListSubType

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

AdvancedDelivery：将此值用于钓鱼模拟 URL。有关详细信息，请参阅配置将第三方网络钓鱼模拟传递给用户和未筛选邮件到 SecOps 邮箱。
租户：这是默认值。

Type:	ListSubType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ListType

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

FileHash
发件人
URL

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

Type:	ListType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-NoExpiration

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

此开关可用于块条目或 URL 允许 ListSubType 参数值为 AdvancedDelivery 的条目。

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Notes

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-OutputJson

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

通过