New-TenantAllowBlockListItems
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet New-TenantAllowBlockListItems para adicionar entradas à 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
New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-SubmissionID <String>]
[<CommonParameters>] New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-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). Como não usamos os parâmetros ExpirationDate ou NoExpiration, a entrada expira após 30 dias.
Exemplo 2
New-TenantAllowBlockListItems -ListType FileHash -Block -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpirationEste exemplo adiciona uma entrada de bloco de arquivo para os arquivos especificados que nunca expiram.
Exemplo 3
New-TenantAllowBlockListItems -Allow -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -NoExpirationEste exemplo adiciona uma entrada de permissão de URL para a URL de simulação de phishing de terceiros especificada sem expiração. 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.
Parâmetros
-Allow
A opção Permitir especifica que você está criando uma entrada de permissão. Não é preciso especificar um valor com essa opção.
Você não pode usar essa opção com a opção Bloquear.
Observação: consulte Permitir entradas na Lista de Permissões/Blocos do Locatário antes de tentar criar uma entrada de permissão.
Você também pode usar entradas de permissão para URLs de simulação de phishing de terceiros sem expiração. 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.
| 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 Permitir especifica que você está criando uma entrada de bloco. Não é preciso especificar um valor com essa opção.
Você não pode usar essa opção com a opção Permitir.
| 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 os valores que você deseja adicionar à Lista de Permissões/Blocos do Locatário com base no valor do parâmetro ListType:
- FileHash: use o valor de hash SHA256 do arquivo. No Windows, você pode encontrar o valor de hash SHA256 executando o seguinte comando em um Prompt de Comando:
certutil.exe -hashfile "<Path>\<Filename>" SHA256. Um valor de exemplo é768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3. - Remetente: um valor de endereço de email ou domínio. Por exemplo:
contoso.comoumichelle@contoso.com. - URL: use endereços ou nomes de host IPv4 ou IPv6. Curingas (* e ~) têm suporte em nomes de host. Não há suporte para protocolos, portas TCP/UDP ou credenciais de usuário. Para obter detalhes, confira Sintaxe de URL para a Lista de Permissões/Blocos do Locatário.
Para inserir vários valores, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Para remetentes, arquivos e URLs, o número máximo de entradas de permissão para cada tipo é 500 e o número máximo de entradas de bloco para cada tipo é 500 (1000 entradas no total para cada tipo).
O número máximo de caracteres em uma entrada de arquivo é 64 e o número máximo de caracteres em uma entrada de URL é 250.
Você não pode misturar tipos de valor (arquivo, remetente ou URL) ou permitir e bloquear ações no mesmo comando.
Na maioria dos casos, você não pode modificar os valores de URL, arquivo ou remetente depois de criar a entrada. A única exceção é permitir entradas de URL para simulações de phishing (ListType = URL, ListSubType = AdvancedDelivery).
| 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 |
-ListSubType
O parâmetro ListSubType especifica o subtipo dessa entrada. 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 a ser adicionada. Os valores válidos são:
- FileHash
- Remetente
- Url
| 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 |
-LogExtraDetails
{{ Preencher LogExtraDetails Description }}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, 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 nos seguintes cenários:
- Com a opção Bloquear.
- Com a opção Permitir em que o valor do parâmetro ListType é URL e 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 |
-SubmissionID
Esse parâmetro está reservado para uso interno da Microsoft.
| 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 |