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.usersQuesto 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.usersIn 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 nellahttps://contoso.sharepoint.com/sites/doctorsraccolta siti) eSiteContent_<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 |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per