Set-TenantAllowBlockListItems
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet Set-TenantAllowBlockListItems para modificar entradas na Lista de Permissões/Bloqueios de Inquilinos 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, 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). 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 não Microsoft e entrega de e-mail para caixas de correio SecOps.
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
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 o URL de simulação de phishing especificado que não seja da 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 modificar 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O comutador Bloquear especifica que está a modificar 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Entradas especifica as entradas que pretende modificar com base no valor do parâmetro ListType. Os valores válidos são:
- FileHash: o valor hash de ficheiro SHA256 exato.
- Domínios e endereços de e-mail do remetente: o valor exato de domínio ou endereço de e-mail.
- URL: o valor exato do URL.
- IP: apenas endereços IPv6. Os endereços IPv6 únicos no formato de compressão colon-hexadecimal ou zero ou IPv6 CIDR variam entre 1 e 128.
Este valor é apresentado na propriedade Valor da entrada na saída do cmdlet Get-TenantAllowBlockListItems.
Não pode misturar tipos de valor (remetente, URL, ficheiro ou endereço IP) nem permitir e bloquear ações no mesmo comando.
Não pode utilizar este 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ExpirationDate filtra os resultados por data de expiração na 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
(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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro IDs especifica as entradas que pretende modificar. Este valor é apresentado na propriedade Identidade na saída do cmdlet Get-TenantAllowBlockListItems.
Um valor de exemplo para este parâmetro é RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.
Não pode utilizar este 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ListSubType especifica ainda mais a entrada que pretende modificar. Os valores válidos são:
- AdvancedDelivery: utilize este 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 não Microsoft e entrega de e-mail para caixas de correio secOps.
- Inquilino: este valor é a predefiniçã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 que pretende modificar. Os valores válidos são:
- FileHash
- Remetente
- Url
- IP
Utilize o parâmetro Entradas ou IDs com este parâmetro para identificar a entrada propriamente dita.
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, 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 com os seguintes tipos de entradas:
- Bloquear entradas.
- O URL permite entradas em que o valor do parâmetro ListSubType é AdvancedDelivery.
- Entradas de permissões de endereço IP.
Não pode utilizar este comutador 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, 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.
Não pode utilizar este 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 dependa 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 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.