Condividi tramite


Get-ComplianceSecurityFilter

Questo cmdlet funziona solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.

Usare il cmdlet Get-ComplianceSecurityFilter per visualizzare i filtri di sicurezza di conformità nel Portale di conformità di Microsoft Purview. Questi filtri consentono agli utenti specificati di eseguire ricerche solo in un subset di cassette postali e in SharePoint Online o OneDrive for Business siti nell'organizzazione di Microsoft 365.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

I filtri di sicurezza di conformità funzionano con le ricerche di conformità nel Portale di conformità di Microsoft Purview (cmdlet*-ComplianceSearch), non In-Place ricerche eDiscovery in Exchange Online (cmdlet*-MailboxSearch).

Per usare questo cmdlet in Security & Compliance PowerShell, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.

Esempio

Esempio 1

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

Questo esempio restituisce un elenco riepilogativo di tutti i filtri di sicurezza di conformità.

Esempio 2

Get-ComplianceSecurityFilter -FilterName "HR Filter"

Questo esempio restituisce informazioni dettagliate sul filtro di sicurezza di conformità denominato "HR Filter".

Parametri

-Action

Il parametro Action filtra i risultati in base al tipo di azione di ricerca a cui viene applicato un filtro. I valori validi sono:

  • Esporta: il filtro viene applicato durante l'esportazione dei risultati della ricerca o la preparazione per l'analisi in eDiscovery Premium.
  • Anteprima: il filtro viene applicato durante l'anteprima dei risultati della ricerca.
  • Eliminazione: il filtro viene applicato quando si eliminano i risultati della ricerca. La modalità di eliminazione degli elementi viene controllata dal valore del parametro PurgeType nel cmdlet New-ComplianceSearchAction. Il valore predefinito è SoftDelete, ovvero gli elementi eliminati sono recuperabili dagli utenti fino alla scadenza del periodo di conservazione degli elementi eliminati.
  • Ricerca: il filtro viene applicato durante l'esecuzione di una ricerca.
  • Search: il filtro viene applicato durante l'esecuzione di una ricerca.
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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

Il parametro FilterName consente di specificare il nome del filtro di sicurezza di conformità da visualizzare. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

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

Il parametro User filtra i risultati in base all'utente che ottiene un filtro applicato alle ricerche. I valori validi sono:

  • L'indirizzo di posta elettronica o alias di un utente.
  • Il valore All.
  • Il nome di un gruppo di ruoli.
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

L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .

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