New-RetentionComplianceRule
Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.
Usare il cmdlet New-RetentionComplianceRule per creare nuove regole di conservazione nel Portale di conformità di Microsoft Purview.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-RetentionComplianceRule
-ApplyComplianceTag <String>
-Policy <PolicyIdParameter>
[-ContentContainsSensitiveInformation <PswsHashtable[]>]
[-Confirm]
[-ContentMatchQuery <String>]
[-ExpirationDateOption <String>]
[-IRMRiskyUserProfiles <String>]
[-MachineLearningModelIDs <MultiValuedProperty>]
[-PriorityCleanup]
[-RetentionComplianceAction <String>]
[-WhatIf]
[<CommonParameters>] New-RetentionComplianceRule
[-Name] <String>
-Policy <PolicyIdParameter>
[-Comment <String>]
[-ExcludedItemClasses <MultiValuedProperty>]
[-RetentionDuration <Unlimited>]
[-RetentionDurationDisplayHint <HoldDurationHint>]
[-Confirm]
[-ContentMatchQuery <String>]
[-ExpirationDateOption <String>]
[-PriorityCleanup]
[-RetentionComplianceAction <String>]
[-WhatIf]
[<CommonParameters>] New-RetentionComplianceRule
-Policy <PolicyIdParameter>
-PublishComplianceTag <String>
[-Confirm]
[-ExpirationDateOption <String>]
[-PriorityCleanup]
[-RetentionComplianceAction <String>]
[-WhatIf]
[<CommonParameters>] Descrizione
La regola di conservazione deve essere aggiunta a un criterio di conservazione esistente utilizzando il parametro Policy. È possibile aggiungere solo una regola a ogni criterio di conservazione.
Per usare questo cmdlet in PowerShell per sicurezza e conformità, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.
Esempio
Esempio 1
New-RetentionComplianceRule -Name InternalCompanyRule -Policy "Internal Company Policy" -RetentionDuration UnlimitedIn questo esempio viene creata una nuova regola di blocco maiuscole/minuscole denominata InternalCompanyRule e viene aggiunta al criterio di blocco dei casi esistente denominato "Criteri aziendali interni". Il contenuto verrà mantenuto a tempo indeterminato.
Esempio 2
New-RetentionComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -RetentionDuration 365 -RetentionComplianceAction KeepAndDelete -ExpirationDateOption ModificationAgeInDaysQuesto esempio crea una nuova regola di conservazione denominata SeptOneYear e la aggiunge ai criteri di conservazione esistenti denominati "Criteri aziendali interni". Il contenuto verrà conservato per un anno a partire dall'ultima modifica del contenuto prima dell'eliminazione.
Parametri
-ApplyComplianceTag
Il parametro ApplyComplianceTag specifica l'etichetta applicata ai messaggi di posta elettronica o ai documenti dalla regola (che influisce sulla durata del periodo di conservazione del contenuto). Un valore valido per questo parametro è il nome di un'etichetta esistente. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.
Visualizzare e creare etichette utilizzando i cmdlet Get-ComplianceTag e New-ComplianceTag.
Non è possibile utilizzare questa opzione con i parametri Name o PublishComplianceTag.
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Comment
Il parametro Comment consente di specificare un commento facoltativo. Se si specifica un valore che contiene degli spazi, è necessario racchiuderlo tra virgolette ("); ad esempio: "Questa è una nota per amministratori".
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-ContentContainsSensitiveInformation
Il parametro ContentContainsSensitiveInformation specifica una condizione per la regola basata su una corrispondenza del tipo di informazioni sensibili nel contenuto. La regola viene applicata al contenuto che presenta il tipo di informazioni sensibili specificato.
Il parametro utilizza la sintassi di base seguente: @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...). Ad esempio, @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).
Utilizzare il cmdlet Get- DLPSensitiveInformationType per elencare i tipi di informazioni sensibili per l'organizzazione. Per altre informazioni sui tipi di informazioni sensibili, vedere Elementi cercati dai tipi di informazioni sensibili in Exchange.
È possibile utilizzare tale parametro con il parametro ApplyComplianceTag.
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Tipo: | PswsHashtable[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-ContentMatchQuery
Il parametro ContentMatchQuery consente di specificare un filtro di ricerca dei contenuti.
Questo parametro utilizza una stringa di ricerca di testo o una query formattata tramite il linguaggio KQL (Keyword Query Language). Per altre informazioni, vedere Informazioni di riferimento sulla sintassi KQL (Keyword Query Language) e Query con parole chiave e condizioni di ricerca per eDiscovery.
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-ExcludedItemClasses
Il parametro ExcludedItemClasses consente di specificare i tipi di messaggi da escludere dalla regola. È possibile utilizzare questo parametro solo per escludere gli elementi da un criterio di blocco, che esclude la classe di elementi specificata dal blocco. L'uso di questo parametro non esclude gli elementi dai criteri di eliminazione. In genere, si usa questo parametro per escludere i messaggi vocali, le conversazioni di messaggistica istantanea e altri contenuti Skype for Business Online da un criterio di blocco. I valori Skype for Business comuni includono:
- IPM. Note.Microsoft.Conversation
- IPM. Note.Microsoft.Conversation.Voice
- IPM. Note.Microsoft.Missed
- IPM. Note.Microsoft.Missed.Voice
- IPM. Note.Microsoft.Voicemail
- IPM.Note.Microsoft.VoiceMessage.UA
- IPM. Note.Microsoft.Voicemail.UM
- IPM.Note.Microsoft.Voicemail.UM.CA
È anche possibile specificare classi di messaggi per gli elementi di Exchange e le classi di messaggi personalizzate o di terze parti. Si noti che i valori specificati non vengono convalidati, quindi il parametro accetta qualsiasi valore di testo.
È possibile specificare più valori della classe elemento usando la sintassi seguente: "Value1","Value2",..."ValueN".
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-ExpirationDateOption
Il parametro ExpirationDateOption specifica se la data di scadenza viene calcolata dalla data di creazione del contenuto o dall'ultima modifica. I valori validi sono:
- CreationAgeInDays
- ModificationAgeInDays
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-IRMRiskyUserProfiles
{{ Fill IRMRiskyUserProfiles Description }}
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-MachineLearningModelIDs
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Name
Il parametro Name consente di specificare un nome univoco per la regola di conservazione. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.
Non è possibile utilizzare questa opzione con i parametri ApplyComplianceTag o PublishComplianceTag.
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Policy
Il parametro Policy consente di specificare il criterio che deve contenere la regola.
| Tipo: | PolicyIdParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-PriorityCleanup
{{ Fill PriorityCleanup Description }}
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-PublishComplianceTag
Il parametro PublishComplianceTag consente di specificare l'etichetta pubblicata per la regola, che rende l'etichetta visibile agli utenti nelle app, ad esempio Outlook, SharePoint e OneDrive. Un valore valido per questo parametro è il nome di un'etichetta esistente. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.
Visualizzare e creare etichette utilizzando i cmdlet Get-ComplianceTag e New-ComplianceTag.
Non è possibile usare questo parametro negli scenari seguenti:
- Con i parametri Name o ApplyComplianceTag.
- Per le regole di conservazione di Teams.
- Con i criteri degli allegati cloud.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RetentionComplianceAction
Il parametro RetentionComplianceAction specifica l'azione di conservazione per la regola. I valori validi sono:
- Elimina
- Conservare
- KeepAndDelete
Se non si usa questo parametro, i criteri di conservazione vengono creati come criteri "UniH" anziché come criteri "mbx".
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RetentionDuration
Il parametro RetentionDuration consente di specificare la durata della conservazione per la regola di archiviazione. I valori validi sono:
- Un numero intero: durata del blocco in giorni.
- Illimitato: il contenuto viene mantenuto a tempo indeterminato.
| Tipo: | Unlimited |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RetentionDurationDisplayHint
Il parametro RetentionDurationDisplayHint specifica le unità usate per visualizzare la durata della conservazione nel Portale di conformità di Microsoft Purview. I valori validi sono:
- Giorni
- Mesi
- Anni
Ad esempio, se questo parametro è impostato sul valore Years e il parametro RetentionDuration è impostato sul valore 365, il Portale di conformità di Microsoft Purview visualizzerà 1 anno come durata del blocco del contenuto.
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Tipo: | HoldDurationHint |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-WhatIf
Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |