Get-ComplianceSecurityFilter
Este cmdlet funciona somente no PowerShell de Segurança & Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Use o cmdlet Get-ComplianceSecurityFilter para exibir os filtros de segurança de conformidade no portal de conformidade do Microsoft Purview. Esses filtros permitem que usuários especificados pesquisem apenas um subconjunto de caixas de correio e sites do SharePoint ou do OneDrive 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.
Sintaxe
Default (Default)
Get-ComplianceSecurityFilter
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-FilterName <String>]
[-User <String>]
[-WhatIf]
[<CommonParameters>]
Description
Os filtros de segurança de conformidade funcionam com pesquisas de conformidade no portal de conformidade do Microsoft Purview (cmdlets *-ComplianceSearch), não In-Place pesquisas de Descoberta Eletrônica 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, Segurança & Conformidade
O parâmetro Action filtra os resultados pelo tipo de ação de pesquisa à qual um filtro é aplicado. Os valores válidos são:
- Exportar: o filtro é aplicado ao exportar resultados de pesquisa ou prepará-los para análise no eDiscovery Premium.
- Visualização: o filtro é aplicado ao visualizar os resultados da pesquisa.
- Limpar: o filtro é aplicado ao limpar os resultados da pesquisa. A forma como os itens são excluídos é controlada pelo valor do parâmetro PurgeType no cmdlet New-ComplianceSearchAction. O valor padrão é SoftDelete, o que significa que os itens removidos podem ser recuperados pelos usuários até que o período de retenção de itens excluídos expire.
- Pesquisa: o filtro é aplicado durante a execução de 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, Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
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, Segurança & Conformidade
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, Segurança & Conformidade
O parâmetro User filtra os resultados pelo usuário que recebe 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.
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
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteraçã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 |
| 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.