Set-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 Set-ComplianceSecurityFilter para modificar os filtros de segurança de conformidade no portal de conformidade do Microsoft Purview.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-ComplianceSecurityFilter
-FilterName <String>
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-Description <String>]
[-Filters <MultiValuedProperty>]
[-Region <String>]
[-Users <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
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
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.add("pilarp@contoso.com")
Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users
Este exemplo adiciona usuário pilarp@contoso.com ao filtro de segurança de conformidade denominado Filtro de Usuários de Ottawa sem afetar outros usuários atribuídos ao filtro.
Exemplo 2
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.remove("annb@contoso.com")
Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users
Este exemplo remove o usuário annb@contoso.com do filtro de segurança de conformidade denominado Filtro de Usuários de Ottawa sem afetar outros usuários atribuídos ao filtro.
Parâmetros
-Action
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Segurança & Conformidade
O parâmetro Action especifica o tipo de ação de pesquisa à qual o filtro é aplicado. Um valor válido para esse parâmetro é All, o que significa que o filtro é aplicado a todas as ações de pesquisa.
- 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
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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 |
-Description
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Segurança & Conformidade
O parâmetro Description especifica uma descrição para o filtro de segurança de conformidade. O comprimento máximo é de 256 caracteres. 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 |
-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 modificar. 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: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Filters
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Segurança & Conformidade
O parâmetro Filters especifica os critérios de pesquisa para o filtro de segurança de conformidade. Você pode criar três tipos diferentes de filtros:
- Filtro de caixa de correio: especifica as caixas de correio que podem ser pesquisadas pelos usuários atribuídos. A sintaxe válida é
Mailbox_<MailboxPropertyName>, onde<MailboxPropertyName>é um valor de propriedade de caixa de correio. Por exemplo,"Mailbox_CustomAttribute10 -eq 'OttawaUsers'"permite que os usuários pesquisem apenas caixas de correio que tenham o valor OttawaUsers na propriedade CustomAttribute10. Para obter uma lista de propriedades de caixa de correio com suporte, consulte Propriedades filtráveis para o parâmetro RecipientFilter. - Filtro de conteúdo da caixa de correio: especifica o conteúdo da caixa de correio que os usuários atribuídos podem pesquisar. A sintaxe válida é
MailboxContent_<SearchablePropertyName>, em que<SearchablePropertyName>especifica uma propriedade QL por palavra-chave (KQL) que pode ser especificada em uma pesquisa de conformidade. Por exemplo,"MailboxContent_Recipients -like 'contoso.com'"permite que os usuários pesquisem apenas mensagens enviadas a destinatários no domínio contoso.com. Para obter uma lista de propriedades de email pesquisáveis, consulte Consultas de palavra-chave para descoberta eletrônica. - Filtro de site e conteúdo do site: há dois filtros relacionados ao site do SharePoint e do OneDrive que você pode criar:
Site_<SearchableSiteProperty>(especifica propriedades relacionadas ao site. Por exemplo,"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'"permite que os usuários pesquisem apenas conteúdo nohttps://contoso.sharepoint.com/sites/doctorsconjunto de sites) eSiteContent_<SearchableSiteProperty>(especifica propriedades relacionadas ao conteúdo. Por exemplo,"SiteContent_FileExtension -eq 'docx'"permite que os usuários pesquisem apenas documentos do Word). Para obter uma lista de propriedades de site pesquisáveis, consulte Visão geral das propriedades rastreadas e gerenciadas no Servidor do SharePoint. As propriedades marcadas com um Sim na coluna Consultável podem ser usadas para criar um filtro de site ou de conteúdo de site.
Você pode especificar vários filtros do mesmo tipo. Por exemplo, "Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'".
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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 |
-Region
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Segurança & Conformidade
O parâmetro Region especifica o local do satélite para locatários multigeográficos realizarem pesquisas de Descoberta Eletrônica. Os valores válidos são:
- APC: Asia-Pacific
- AUS: Austrália
- CAN: Canadá
- EUR: Europa, Oriente Médio, África
- FRA: França
- GBR: Reino Unido
- IND: Índia
- Japão: Japão
- LAM: América Latina
- NAM: América do Norte
Se você não usar esse parâmetro em um locatário multigeográfico, as pesquisas de Descoberta Eletrônica serão executadas no local central.
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 |
-Users
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Segurança & Conformidade
O parâmetro Users especifica o usuário que tem esse filtro aplicado às suas pesquisas. Os valores válidos são:
- Um ou mais usuários: identifique os usuários por seu alias ou endereço de email. Vários valores, separados por vírgulas, podem ser especificados.
- O valor Todos: Atribui o filtro a todos os usuários. Você só pode usar esse valor sozinho.
- Um ou mais grupos de funções: identifique o grupo de funções pelo nome. Vários valores, separados por vírgulas, podem ser especificados.
Você não pode especificar um grupo de distribuição com esse parâmetro.
Os valores especificados substituem quaisquer entradas existentes. Consulte a seção Exemplos para adicionar ou remover usuários sem afetar outras entradas existentes.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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.