Get-TenantAllowBlockListItems

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

使用 Get-TenantAllowBlockListItems cmdlet 在Microsoft 365 Defender门户中查看租户允许/阻止列表中的条目。

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

语法

Get-TenantAllowBlockListItems
   -ListType <ListType>
   [-ExpirationDate <DateTime>]
   [-Allow]
   [-Block]
   [-Entry <String>]
   [-ListSubType <ListSubType[]>]
   [-OutputJson]
   [<CommonParameters>]
Get-TenantAllowBlockListItems
   -ListType <ListType>
   [-NoExpiration]
   [-Allow]
   [-Block]
   [-Entry <String>]
   [-ListSubType <ListSubType[]>]
   [-OutputJson]
   [<CommonParameters>]

说明

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

示例

示例 1

Get-TenantAllowBlockListItems -ListType Url -Block

此示例返回所有阻止的 URL。

示例 2

Get-TenantAllowBlockListItems -ListType FileHash -Entry "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"

此示例返回指定文件哈希值的信息。

示例 3

Get-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery

此示例返回所有允许的第三方钓鱼模拟 URL 的信息。 有关详细信息,请参阅 配置将第三方网络钓鱼模拟传递给用户和未筛选邮件到 SecOps 邮箱

参数

-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

-Entry

Entry 参数根据 ListType 参数值筛选结果。 有效值包含:

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

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

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

-ExpirationDate

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

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

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

-ListSubType

ListSubType 参数按子类型筛选结果。 有效值包含:

  • AdvancedDelivery
  • 租户:这是默认值。
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
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 开关按设置为永不过期的条目筛选结果。 不必为此开关指定值。

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

-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