Set-TenantAllowBlockListItems

Módulo:

Exchange PowerShell

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/Bloqueios de Locatário no portal Microsoft Defender.

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

Sintaxe

Ids (Default)

Set-TenantAllowBlockListItems
    -Ids <String[]>
    -ListType <ListType>
    [-Allow]
    [-Block]
    [-ExpirationDate <DateTime>]
    [-ListSubType <ListSubType>]
    [-NoExpiration]
    [-Notes <String>]
    [-OutputJson]
    [-RemoveAfter <Int32>]
    [<CommonParameters>]

Entries

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

Description

Na maioria dos casos, você não pode modificar os valores de endereço, URL, arquivo ou IP depois de criar a entrada. A única exceção são as entradas de permissão de URL para simulações de phishing (ListType = URL, ListSubType = AdvancedDelivery). Para obter mais informações sobre como permitir URLs para simulações de phishing, consulte Configurar a política de entrega avançada para simulações de phishing que não são da Microsoft e entrega de email para caixas de correio SecOps.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 expiração da entrada especificada.

Exemplo 2

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

Este exemplo altera a data de expiração da entrada de permissão de URL para a URL especificada de simulação de phishing que não é da Microsoft.

Parâmetros

-Allow

Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

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

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, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

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

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, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

O parâmetro Entries 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 de hash do arquivo SHA256.
• Domínios e endereços de email do remetente: o valor exato do domínio ou endereço de email.
• URL: o valor exato da URL.
• IP: somente endereços IPv6. Endereços IPv6 únicos no formato hexadecimal de dois pontos ou compactação zero ou CIDR O IPv6 varia de 1 a 128.

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

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

Não é possível usar esse parâmetro com o parâmetro Ids.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Entries

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, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

O parâmetro ExpirationDate filtra os resultados por data de expiração 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.

Não é possível usar esse 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

(All)

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

-Ids

Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

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 exemplo de valor para esse parâmetro é RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.

Não é possível usar esse parâmetro com o parâmetro Entradas.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Ids

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

-ListSubType

Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

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

• AdvancedDelivery: use esse valor para URLs de simulação de phishing. Para obter mais informações, consulte Configurar a política de entrega avançada para simulações de phishing que não são da Microsoft e entrega de email para caixas de correio do SecOps.
• Locatário: esse valor é o padrã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, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

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

• FileHash
• Remetente
• Url
• IP

Use o parâmetro Entries ou Ids com esse parâmetro para identificar a entrada em si.

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

-NoExpiration

Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

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

Esta opção está disponível para uso com os seguintes tipos de entradas:

• Bloquear entradas.
• URL permite entradas em que o valor do parâmetro ListSubType é AdvancedDelivery.
• Endereço IP permitir entradas.

Não é possível usar essa opção com o parâmetro ExpirationDate.

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:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Notes

Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

Os parâmetros Notes especificam informações adicionais sobre o objeto. Se o valor contiver espaços, coloque-o entre aspas ("). Se o valor contiver aspas, adicione uma barra invertida ( \ ) antes das 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, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

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

Use essa opção para evitar 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, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais

O parâmetro RemoveAfter habilita o recurso Remover em>45 dias após a data do último uso para uma entrada de permissão. A propriedade LastUsedDate é preenchida quando a entidade inválida na entrada de permissão é encontrada pelo sistema de filtragem durante o fluxo de emails ou o tempo de clique. A entrada de permissão é mantida por 45 dias após o sistema de filtragem determinar que a entidade está limpa.

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

Não é possível usar esse parâmetro com os parâmetros ExpirationDate ou NoExpirationDate.

Para alterar a entrada de permissão para um valor de data/hora de expiração estático que não depende da propriedade LastUsedDate, execute um comando Set-TenantAllowBlockListItems com o parâmetro ExpirationDate.

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

CommonParameters

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