Partilhar via

New-TenantAllowBlockListItems

Módulo:
Exchange PowerShell

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

Expiration 

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

NoExpiration 

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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 não Microsoft especificado sem expiração. Para obter mais informações, consulte Configurar a política de entrega avançada para simulações de phishing não Microsoft 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

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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 não Microsoft sem expiração. Para obter mais informações, consulte Configurar a política de entrega avançada para simulações de phishing não Microsoft e entrega de e-mail para caixas de correio secOps.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Block

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Entries

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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):

  • Organizações sem Microsoft Defender para Office 365: o número máximo de entradas de permissão é 500 e o número máximo de entradas de bloco é 500.
  • Organizações com o 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.
  • Organizações com o 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).

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExpirationDate

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Expiration
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ListSubType

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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

Propriedades do parâmetro

Tipo:ListSubType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ListType

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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

  • FileHash
  • Remetente
  • Url
  • IP

Propriedades do parâmetro

Tipo:ListType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LogExtraDetails

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NoExpiration

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NoExpiration
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Notes

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OutputJson

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveAfter

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SubmissionID

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.