Condividi tramite


Set-ComplianceSecurityFilter

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

Usare il cmdlet Set-ComplianceSecurityFilter per modificare i filtri di sicurezza di conformità nel Portale di conformità di Microsoft Purview.

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

Sintassi

Set-ComplianceSecurityFilter
   -FilterName <String>
   [-Action <ComplianceSecurityFilterActionType>]
   [-Confirm]
   [-Description <String>]
   [-Filters <MultiValuedProperty>]
   [-Region <String>]
   [-Users <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

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

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.add("pilarp@contoso.com")

Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

Questo esempio aggiunge l'utente pilarp@contoso.com al filtro di sicurezza di conformità denominato Ottawa Users Filter senza influire sugli altri utenti assegnati al filtro.

Esempio 2

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.remove("annb@contoso.com")

Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

In questo esempio viene rimosso l'utente annb@contoso.com dal filtro di sicurezza di conformità denominato Ottawa Users Filter senza influire sugli altri utenti assegnati al filtro.

Parametri

-Action

Il parametro Action specifica il tipo di azione di ricerca a cui viene applicato il filtro. Un valore valido per questo parametro è All, ovvero il filtro viene applicato a tutte le azioni di ricerca.

  • 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

-Description

Il parametro Description consente di specificare una descrizione per il filtro di sicurezza di conformità. La lunghezza massima è 256 caratteri. 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

-FilterName

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

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

-Filters

Il parametro Filters consente di specificare i criteri di ricerca per il filtro di sicurezza di conformità. È possibile creare tre diverse tipologie di filtri:

  • Filtro cassette postali: specifica le cassette postali che possono essere ricercate dagli utenti assegnati. La sintassi valida è Mailbox_<MailboxPropertyName>, dove <MailboxPropertyName> è un valore della proprietà della cassetta postale. Ad esempio,"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" consente agli utenti di eseguire ricerche solo nelle cassette postali con il valore OttawaUsers nella proprietà CustomAttribute10. Per un elenco delle proprietà della cassetta postale supportate, vedere Proprietà filtrabili per il parametro RecipientFilter.
  • Filtro contenuto cassetta postale: specifica il contenuto della cassetta postale che gli utenti assegnati possono cercare. La sintassi valida è MailboxContent_<SearchablePropertyName>, dove <SearchablePropertyName> specifica una proprietà KQL (Keyword Query Language) che può essere specificata in una ricerca di conformità. Ad esempio, "MailboxContent_Recipients -like 'contoso.com'" consente agli utenti di cercare solo i messaggi inviati ai destinatari nel dominio contoso.com. Per un elenco delle proprietà di posta elettronica ricercabili, vedere Query con parole chiave per eDiscovery.
  • Filtro contenuto sito e sito: sono disponibili due filtri di SharePoint Online e OneDrive for Business correlati al sito che è possibile creare: Site_<SearchableSiteProperty> (specifica le proprietà correlate al sito. Ad esempio,"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'" consente agli utenti di cercare solo il contenuto nella https://contoso.sharepoint.com/sites/doctors raccolta siti) e SiteContent_<SearchableSiteProperty> (specifica le proprietà correlate al contenuto. Ad esempio, "SiteContent_FileExtension -eq 'docx'" consente agli utenti di cercare solo documenti di Word). Per un elenco delle proprietà del sito ricercabili, vedere Panoramica delle proprietà sottoposte a ricerca per indicizzazione e gestite in SharePoint Server. Le proprietà contrassegnate con Sì nella colonna Disponibile per query possono essere utilizzate per creare un filtro dei siti o dei contenuti dei siti.

È possibile specificare più filtri dello stesso tipo. Ad esempio, "Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'".

Type:MultiValuedProperty
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

-Region

Il parametro Region consente di specificare la posizione satellite in cui i tenant multi-geo devono eseguire ricerche eDiscovery. I valori validi sono:

  • APC: Asia-Pacific
  • AUS: Australia
  • CAN: Canada
  • EUR: Europa, Medio Oriente, Africa
  • FRA: Francia
  • GBR: Regno Unito
  • IND: India
  • JPN: Giappone
  • LAM: America Latina
  • NAM: America del Nord

Se non si usa questo parametro in un tenant multi-geografico, le ricerche di eDiscovery vengono eseguite nella posizione centrale.

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

-Users

Il parametro Users consente di specificare l'utente che visualizza questo filtro applicato alle ricerche. I valori validi sono:

  • Uno o più utenti: identificare gli utenti in base all'alias o all'indirizzo di posta elettronica. È possibile specificare più valori separati da virgole.
  • Valore All: assegna il filtro a tutti gli utenti. È possibile utilizzare questo valore solo singolarmente.
  • Uno o più gruppi di ruoli: identificare il gruppo di ruoli in base al nome. È possibile specificare più valori separati da virgole.

Non è possibile specificare gruppi di distribuzione con questo parametro.

I valori specificati sovrascriveranno le voci esistenti. Vedere la sezione Esempi per aggiungere o rimuovere gli utenti senza influire su altre voci esistenti.

Type:MultiValuedProperty
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