Partilhar via


Get-TenantAllowBlockListItems

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Get-TenantAllowBlockListItems para exibir 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

Get-TenantAllowBlockListItems
   -ListType <ListType>
   [-ExpirationDate <DateTime>]
   [-Allow]
   [-Block]
   [-Entry <String>]
   [-ListSubType <ListSubType[]>]
   [-OutputJson]
   [<CommonParameters>]
Get-TenantAllowBlockListItems
   -ListType <ListType>
   [-NoExpiration]
   [-Allow]
   [-Block]
   [-Entry <String>]
   [-ListSubType <ListSubType[]>]
   [-OutputJson]
   [<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

Get-TenantAllowBlockListItems -ListType Url -Block

Este exemplo retorna todas as URLs bloqueadas.

Exemplo 2

Get-TenantAllowBlockListItems -ListType FileHash -Entry "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"

Este exemplo retorna informações para o valor de hash do arquivo especificado.

Exemplo 3

Get-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery

Este exemplo retorna informações para todas as URLs de simulação de phishing de terceiros permitidas. 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 filtra os resultados para permitir entradas. 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 filtra os resultados de entradas 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

-Entry

O parâmetro Entry filtra os resultados com base no valor do parâmetro ListType. Os valores válidos são:

  • FileHash: o valor exato do hash do arquivo SHA256.
  • Remetente: o valor exato do domínio ou endereço de email.
  • Url: o valor exato da URL.

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

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

-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.
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 filtra os resultados por subtipo. Os valores válidos são:

  • AdvancedDelivery
  • 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 a lista a ser exibida. 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

-NoExpiration

A opção NoExpiration filtra os resultados por entradas definidas para nunca expirar. Não é preciso especificar um valor com essa opção.

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

-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