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:
- AdvancedDelivery: use esse valor para URLs de simulação de phishing. Para obter mais informações, consulte Configure a entrega de simulações de phishing de terceiros para usuários e mensagens não filtradas nas caixas de correio SecOps.
- Locatário: esse é o valor padrã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 |