Partilhar via

Get-TenantAllowBlockListItems

Módulo:
Exchange PowerShell

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

Utilize o cmdlet Get-TenantAllowBlockListItems para ver entradas na Lista de Permissões/Bloqueios de Inquilinos no portal do Microsoft Defender.

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

Sintaxe

Expiration (Default) 

Get-TenantAllowBlockListItems
    -ListType <ListType>
    [-ExpirationDate <DateTime>]
    [-Allow]
    [-Block]
    [-Entry <String>]
    [-ListSubType <ListSubType[]>]
    [-OutputJson]
    [<CommonParameters>]

NoExpiration 

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 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

Get-TenantAllowBlockListItems -ListType Url -Block

Este exemplo devolve todos os URLs bloqueados.

Exemplo 2

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

Este exemplo devolve informações para o valor hash de ficheiro especificado.

Exemplo 3

Get-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery

Este exemplo devolve informações para todos os URLs de simulação de phishing permitidos que não sejam da Microsoft. 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.

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 filtra os resultados das entradas 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 filtra os resultados das entradas 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

-Entry

Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local

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

  • FileHash: o valor hash de ficheiro SHA256 exato.
  • 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.

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

-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.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Expiration
Cargo:Named
Obrigatório:False
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 filtra os resultados por subtipo. Os valores válidos são:

  • AdvancedDelivery
  • 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 a lista a ver. Os valores válidos são:

  • FileHash
  • Remetente
  • Url
  • IP

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 filtra os resultados por entradas que estão definidas para nunca expirarem. 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

NoExpiration
Cargo:Named
Obrigatório:True
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

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.