Compartilhar via

New-TenantAllowBlockListItems

Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online, Security & Compliance, Exchange Online Protection

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

Utilize o cmdlet New-TenantAllowBlockListItems para adicionar entradas à Lista de Permissões/Bloqueios de Inquilinos no portal do Microsoft Defender.

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

Sintaxe

New-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-ExpirationDate <DateTime>]
   [-Allow]
   [-Block]
   [-ListSubType <ListSubType>]
   [-LogExtraDetails]
   [-Notes <String>]
   [-OutputJson]
   [-RemoveAfter <Int32>]
   [-SubmissionID <String>]
   [<CommonParameters>]
New-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-NoExpiration]
   [-Allow]
   [-Block]
   [-ListSubType <ListSubType>]
   [-LogExtraDetails]
   [-Notes <String>]
   [-OutputJson]
   [-RemoveAfter <Int32>]
   [-SubmissionID <String>]
   [<CommonParameters>]

Description

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

New-TenantAllowBlockListItems -ListType Url -Block -Entries ~contoso.com~

Este exemplo adiciona uma entrada de bloco de URL para contoso.com e todos os subdomínios (por exemplo, contoso.com, www.contoso.com, xyz.abc.contoso.com e www.contoso.com/b). Uma vez que não utilizámos os parâmetros ExpirationDate ou NoExpiration, a entrada expira após 30 dias.

Exemplo 2

New-TenantAllowBlockListItems -ListType FileHash -Block -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpiration

Este exemplo adiciona uma entrada de bloco de ficheiros para os ficheiros especificados que nunca expiram.

Exemplo 3

New-TenantAllowBlockListItems -Allow -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -NoExpiration

Este exemplo adiciona uma entrada de permissão de URL para o URL de simulação de phishing de terceiros especificado sem expiração. Para obter mais informações, consulte Configurar a política de entrega avançada para simulações de phishing de terceiros e entrega de e-mail para caixas de correio secOps.

Exemplo 4

New-TenantAllowBlockListItems -Allow -ListType Url -Entries abcd.fabrikam.com -RemoveAfter 45

Este exemplo adiciona uma entrada de permissão de URL para o domínio especificado com expiração como 45 dias após a data da última utilização. Isto permite que a entrada permita URLs identificados como bulk, spam, spam de alta confiança e phishing (phishing não de alta confiança).

Para URLs identificados como software maligno ou phishing de alta confiança, tem de submeter os URLs da Microsoft para criar entradas de permissão. Para obter instruções, consulte Comunicar bons URLs à Microsoft.

Parâmetros

-Allow

O comutador Permitir especifica que está a criar uma entrada de permissão. Não é preciso especificar um valor com essa opção.

Não pode utilizar este comutador com o comutador Bloquear.

Nota: consulte Permitir entradas na Lista de Permissões/Bloqueios do Inquilino antes de tentar criar uma entrada de permissão.

Também pode utilizar entradas de permissão para URLs de simulação de phishing de terceiros sem expiração. Para obter mais informações, consulte Configurar a política de entrega avançada para simulações de phishing de terceiros e entrega de e-mail para caixas de correio secOps.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-Block

O comutador Permitir especifica que está a criar uma entrada de bloco. Não é preciso especificar um valor com essa opção.

Não pode utilizar este comutador com o botão Permitir.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-Entries

O parâmetro Entradas especifica os valores que pretende adicionar à Lista de Permissões/Bloqueios do Inquilino com base no valor do parâmetro ListType:

  • FileHash: utilize o valor hash SHA256 do ficheiro. Pode encontrar o valor hash SHA256 ao executar o seguinte comando no PowerShell: Get-FileHash -Path "<Path>\<Filename>" -Algorithm SHA256. Um valor de exemplo é 768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3.

  • Remetente: um valor de domínio ou endereço de e-mail. Por exemplo: contoso.com ou michelle@contoso.com.

  • URL: utilize endereços IPv4 ou IPv6 ou nomes de anfitrião. Os carateres universais (* e ~) são suportados em nomes de anfitrião. Os protocolos, portas TCP/UDP ou credenciais de utilizador não são suportados. Para obter detalhes, veja Sintaxe de URL para a Lista de Permissões/Bloqueios do Inquilino.

  • IP: apenas endereços IPv6:

    • Endereços IPv6 únicos em formato colono-hexadecimal (por exemplo, 2001:0db8:85a3:0000:0000:8a2e:0370:7334).

    • Endereços IPv6 únicos no formato de compressão zero (por exemplo, 2001:db8::1 para 2001:0db8:0000:0000:0000:0000:0000:00001).

    • CIDR IPv6 varia entre 1 e 128 (por exemplo, 2001:0db8::/32).

Para inserir vários valores, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Limites de entrada para cada subtipo de lista (remetente, URL, ficheiro ou endereço IP):

  • Proteção do Exchange Online: o número máximo de entradas de permissão é 500 e o número máximo de entradas de bloco é 500.
  • Defender para Office 365 Plano 1: o número máximo de entradas de permissão é 1000 e o número máximo de entradas de bloco é 1000.
  • Defender para Office 365 Plano 2: o número máximo de entradas de permissão é 5000 e o número máximo de entradas de bloco é 10000.

O número máximo de carateres numa entrada de ficheiro é 64 e o número máximo de carateres numa entrada de URL é 250.

Não pode misturar tipos de valor (remetente, URL, ficheiro ou endereço IP) nem permitir e bloquear ações no mesmo comando.

Na maioria dos casos, não pode modificar os valores de remetente, URL, ficheiro ou endereço IP depois de criar a entrada. A única exceção é o URL permitir entradas para simulações de phishing (ListType = URL, ListSubType = AdvancedDelivery).

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-ExpirationDate

O parâmetro ExpirationDate definiu a data de expiração da entrada em Hora Universal Coordenada (UTC).

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 para UTC: por exemplo, (Get-Date "5/6/2020 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.

Não pode utilizar este parâmetro com os parâmetros NoExpiration ou RemoveAfter.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-ListSubType

O parâmetro ListSubType especifica o subtipo para esta entrada. Os valores válidos são:

Tipo:ListSubType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-ListType

O parâmetro ListType especifica o tipo de entrada a adicionar. Os valores válidos são:

  • FileHash
  • Remetente
  • Url
  • IP
Tipo:ListType
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-LogExtraDetails

{{ Descrição do LogExtraDetails de Preenchimento }}

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-NoExpiration

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

Este comutador está disponível para utilização nos seguintes cenários:

  • Com o comutador Bloquear.
  • Com o parâmetro Permitir onde o valor do parâmetro ListType é URL e o valor do parâmetro ListSubType é AdvancedDelivery.
  • Com o comutador Permitir onde o valor do parâmetro ListType é IP.

Não pode utilizar este comutador com o parâmetro ExpirationDate ou RemoveAfter.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 (").

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-OutputJson

O comutador OutputJson especifica se deve devolver todas as entradas num único valor JSON. Não é preciso especificar um valor com essa opção.

Utilize este comutador para impedir que o comando pare na primeira entrada que contém um erro de sintaxe.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-RemoveAfter

O parâmetro RemoveAfter ativa a funcionalidade Remover em>45 dias após a data da última utilização para uma entrada de permissão. A propriedade LastUsedDate é preenchida quando a entidade incorreta na entrada permitir é encontrada pelo sistema de filtragem durante o fluxo de correio ou a hora de clique. A entrada de permissão é mantida durante 45 dias após o sistema de filtragem determinar que a entidade é limpo.

O único valor válido para este parâmetro é 45.

Pode utilizar este parâmetro com o parâmetro Permitir quando o valor do parâmetro ListType for Remetente, FicheiroHash ou Url.

Não pode utilizar este parâmetro com os parâmetros ExpirationDate ou NoExpirationDate.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection

-SubmissionID

Esse parâmetro está reservado para uso interno da Microsoft.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Security & Compliance, Exchange Online Protection