Get-ComplianceSecurityFilter

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2016, Exchange Server 2019, Security & Compliance

Esse cmdlet é funcional apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, consulte PowerShell de Conformidade de Segurança&.

Use o cmdlet Get-ComplianceSecurityFilter para exibir filtros de segurança de conformidade no portal de conformidade do Microsoft Purview. Esses filtros permitem que os usuários especificados pesquisem apenas um subconjunto de caixas de correio e o SharePoint Online ou OneDrive for Business sites em sua organização do Microsoft 365.

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

Syntax

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 descoberta eletrônica em cmdlets Exchange Online (*-MailboxSearch).

Para usar esse cmdlet no PowerShell de Conformidade de Segurança & , 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

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

  • Exportação: o filtro é aplicado ao exportar resultados de pesquisa ou prepará-los para análise no eDiscovery Premium.
  • Versão prévia: o filtro é aplicado ao visualizar os resultados da pesquisa.
  • Limpeza: o filtro é aplicado ao limpar os resultados da pesquisa. Como os itens são excluídos é controlado pelo valor do parâmetro PurgeType no cmdlet New-ComplianceSearchAction. O valor padrão é SoftDelete, o que significa que os itens limpos são recuperáveis pelos usuários até que o período de retenção de itens excluídos expire.
  • Pesquisa: o filtro é aplicado ao executar uma pesquisa.
  • Search: o filtro é aplicado ao executar uma pesquisa.
Type:ComplianceSecurityFilterActionType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Confirm

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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-FilterName

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 (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-User

O parâmetro Usuário filtra os resultados pelo usuário que obtém um filtro aplicado às suas 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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance