Remove-TenantAllowBlockListItems

Reference

Module:: ExchangePowerShell

Applies to:: Exchange Online, Security & Compliance, Exchange Online Protection

Note: The features described in this topic are in Preview, are subject to change, and are not available in all organizations.

This cmdlet is available only in the cloud-based service.

Use the Remove-TenantAllowBlockListItems cmdlet to remove entries from the Tenant Allow/Block List in the Microsoft 365 Defender portal.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

Syntax

Remove-TenantAllowBlockListItems
      -Entries <String[]>
      -ListType <ListType>
      [-ListSubType <ListSubType>]
      [-OutputJson]
      [<CommonParameters>]

Remove-TenantAllowBlockListItems
      -Ids <String[]>
      -ListType <ListType>
      [-ListSubType <ListSubType>]
      [-OutputJson]
      [<CommonParameters>]

Description

You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.

Examples

Example 1

Remove-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0l"

This example removes the specified URL entry from the Tenant Allow/Block List.

Example 2

Remove-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com

This example removes the URL allow entry for the specified third-party phishing simulation URL. For more information, see Configure the delivery of third-party phishing simulations to users and unfiltered messages to SecOps mailboxes.

Parameters

-Entries

The Entries parameter specifies the entries that you want to remove based on the ListType parameter value. Valid values are:

Url: The exact URL entry value.
File: The exact SHA256 file hash value.

To enter multiple values, use the following syntax: "Value1","Value2",..."ValueN".

You can't mix URL and file values or allow and block actions in the same command.

You can't use this parameter with the Ids parameter.

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

-Ids

The Ids parameter specifies the entries that you want to modify. To find this value, use the Get-TenantAllowBlockListItems cmdlet and the Identity property value (a URL or a file hash).

An example value for this parameter is RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.

To enter multiple values, use the following syntax: "Value1","Value2",..."ValueN".

You can't use this parameter with the Entries parameter.

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

-ListSubType

The ListSubType specifies the subtype of this entry. Valid values are:

AdvancedDelivery
Tenant: This is the default value.

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

-ListType

The ListType parameter specifies the type of entry to remove. Valid values are:

FileHash
Url

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

-OutputJson

The OutputJson switch specifies whether to return all entries in a single JSON value. You don't need to specify a value with this switch.

You use this switch to prevent the command from halting on the first entry that contains a syntax error.

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