Set-TenantAllowBlockListItems

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Set-TenantAllowBlockListItems para modificar entradas na Lista de Permissões/Blocos do Locatário no portal Microsoft 365 Defender.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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>]

Description

Na maioria dos casos, você não pode modificar os valores de URL, arquivo ou remetente de uma entrada existente. A única exceção é permitir entradas de URL para simulações de phishing (Action = Allow, ListType = URL e ListSubType = AdvancedDelivery). Para obter mais informações sobre como permitir URLs para simulações de phishing, consulte Configurar a entrega de simulações de phishing de terceiros para usuários e mensagens não filtradas para caixas de correio SecOps.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

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

Este exemplo altera a data de validade da entrada especificada.

Exemplo 2

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

Este exemplo altera a data de validade da entrada de permissão de URL para a URL de simulação de phishing de terceiros especificada.

Parâmetros

-Allow

A opção Permitir especifica que você está modificando uma entrada de permissão. Não é preciso especificar um valor com essa opção.

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

A opção Bloquear especifica que você está modificando uma entrada de bloco. Não é preciso especificar um valor com essa opção.

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

O parâmetro Entradas especifica as entradas que você deseja modificar com base no valor do parâmetro ListType. Os valores válidos são:

  • FileHash: o valor exato do hash do arquivo SHA256.
  • Domínios de remetente e endereços de email: o valor exato do endereço de email ou domínio.
  • Url: o valor exato da URL.

Esse valor é mostrado na propriedade Value da entrada na saída do cmdlet Get-TenantAllowBlockListItems.

Você não pode misturar tipos de valor (arquivo, remetente ou URL) ou permitir e bloquear ações no mesmo comando.

Você não pode usar esse parâmetro com o parâmetro 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

O parâmetro ExpirationDate filtra os resultados por data de validade em UTC (Tempo Universal Coordenado).

Para especificar um valor de data/hora para este parâmetro, use uma das opções a seguir:

  • Especifique o valor de data/hora em UTC: por exemplo, "2021-05-06 14:30:00z".
  • Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local em UTC: Por exemplo, (Get-Date "5/6/2020 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.

Você não pode usar esse parâmetro com a opção 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

O parâmetro Ids especifica as entradas que você deseja modificar. Esse valor é mostrado na propriedade Identity na saída do cmdlet Get-TenantAllowBlockListItems.

Um valor de exemplo para esse parâmetro é RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.

Você não pode usar esse parâmetro com o parâmetro Entradas.

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

O parâmetro ListSubType especifica ainda mais a entrada que você deseja modificar. Os valores válidos são:

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

O parâmetro ListType especifica o tipo de entrada que você deseja modificar. Os valores válidos são:

  • FileHash
  • Remetente
  • Url

Use o parâmetro Entradas ou IDs com esse parâmetro para identificar a entrada em si.

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

A opção NoExpiration especifica que a entrada nunca deve expirar. Não é preciso especificar um valor com essa opção.

Essa opção está disponível para uso com entradas de bloco ou com entradas de url que permitem entradas em que o valor do parâmetro ListSubType é AdvancedDelivery.

Você não pode usar essa opção com o parâmetro 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

Os parâmetros Notes especificam informações adicionais sobre o objeto. Se o valor contiver espaços, coloque-o entre aspas (").

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

A opção OutputJson especifica se deve retornar todas as entradas em um único valor JSON. Não é preciso especificar um valor com essa opção.

Use essa opção para impedir que o comando pare na primeira entrada que contém um erro de sintaxe.

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