Partilhar via

Get-ComplianceSecurityFilter

Módulo:
Exchange PowerShell

Este cmdlet está funcional apenas no PowerShell de Conformidade do & de Segurança. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..

Utilize o cmdlet Get-ComplianceSecurityFilter para ver filtros de segurança de conformidade no portal de conformidade do Microsoft Purview. Estes filtros permitem aos utilizadores especificados procurar apenas um subconjunto de caixas de correio e sites do SharePoint ou do OneDrive na sua organização do Microsoft 365.

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

Sintaxe

Default (Padrão) 

Get-ComplianceSecurityFilter
    [-Action <ComplianceSecurityFilterActionType>]
    [-Confirm]
    [-FilterName <String>]
    [-User <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

Os filtros de segurança de conformidade funcionam com pesquisas de conformidade nos cmdlets portal de conformidade do Microsoft Purview (*-ComplianceSearch), não In-Place pesquisas de Deteção de Dados Eletrónicos em Exchange Online (*-Cmdlets MailboxSearch).

Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

Get-ComplianceSecurityFilter | Format-Table -Auto FilterName,Action

Este exemplo retorna uma lista resumida de todos os filtros de segurança de conformidade.

Exemplo 2

Get-ComplianceSecurityFilter -FilterName "HR Filter"

Este exemplo retorna informações detalhadas sobre o filtro de segurança de conformidade chamado Filtro HR.

Parâmetros

-Action

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança

O parâmetro Ação filtra os resultados pelo tipo de ação de pesquisa a que um filtro é aplicado. Os valores válidos são:

  • Exportar: o filtro é aplicado ao exportar os resultados da pesquisa ou ao prepará-los para análise na Deteção de Dados Eletrónicos Premium.
  • Pré-visualização: o filtro é aplicado ao pré-visualizar os resultados da pesquisa.
  • Remoção: o filtro é aplicado ao remover os resultados da pesquisa. A forma como os itens são eliminados é controlada pelo valor do parâmetro PurgeType no cmdlet New-ComplianceSearchAction. O valor predefinido é SoftDelete, o que significa que os itens removidos são recuperáveis pelos utilizadores até que o período de retenção dos itens eliminados expire.
  • Pesquisa: o filtro é aplicado ao executar uma pesquisa.
  • Search: o filtro é aplicado ao executar uma pesquisa.

Propriedades do parâmetro

Tipo:ComplianceSecurityFilterActionType
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

-Confirm

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

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

-FilterName

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança

O parâmetro FilterName especifica o nome do filtro de segurança de conformidade que você deseja exibir. 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

-User

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança

O parâmetro Utilizador filtra os resultados pelo utilizador que recebe um filtro aplicado às respetivas pesquisas. Os valores válidos são:

  • O alias ou endereço de email de um usuário.
  • O valor All.
  • O nome de um grupo de função.

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

-WhatIf

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

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.