Set-TenantAllowBlockListItems
此 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 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈