Set-RetentionComplianceRule
Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.
Usare il cmdlet Set-RetentionComplianceRule per modificare le regole di conservazione esistenti nel Portale di conformità di Microsoft Purview.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-RetentionComplianceRule
[-Identity] <ComplianceRuleIdParameter>
[-ApplyComplianceTag <String>]
[-Comment <String>]
[-Confirm]
[-ContentContainsSensitiveInformation <PswsHashtable[]>]
[-ContentDateFrom <DateTime>]
[-ContentDateTo <DateTime>]
[-ContentMatchQuery <String>]
[-ExcludedItemClasses <MultiValuedProperty>]
[-ExpirationDateOption <String>]
[-RetentionComplianceAction <String>]
[-RetentionDuration <Unlimited>]
[-RetentionDurationDisplayHint <HoldDurationHint>]
[-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
Set-RetentionComplianceRule -Identity "Internal Company Rule" -RetentionDuration 180 -RetentionDurationDisplayHint DaysIn questo esempio viene modificata la durata della conservazione per la regola di conservazione esistente denominata "Internal Company Rule".
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 degli 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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: | Security & Compliance |
-ContentContainsSensitiveInformation
Il parametro ContentContainsSensitiveInformation specifica una condizione per la regola basata su una corrispondenza del tipo di informazioni riservate nel contenuto. La regola viene applicata al contenuto che contiene il tipo di informazioni sensibili specificato.
Questo parametro usa la sintassi @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...)di base . Ad esempio, @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).
Usare il cmdlet Get-DLPSensitiveInformationType per elencare i tipi di informazioni riservate per l'organizzazione. Per altre informazioni sui tipi di informazioni riservate, vedere Informazioni sui tipi di informazioni riservate in Exchange.
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Type: | PswsHashtable[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ContentDateFrom
Il parametro ContentDateFrom consente di specificare la data di inizio dell'intervallo di date per i contenuti da includere.
Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ContentDateTo
Il parametro ContentDateTo consente di specificare la data di fine dell'intervallo di date per i contenuti da includere.
Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 che la classe di elementi specificata venga mantenuta. 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. Nota. Microsoft. Conversazione
- IPM. Nota. Microsoft. Conversation.Voice
- IPM. Nota. Microsoft. Perso
- IPM. Nota. Microsoft. Missed.Voice
- IPM. Nota. Microsoft. Segreteria telefonica
- IPM. Nota. Microsoft.VoiceMessage.UA
- IPM. Nota. Microsoft. Voicemail.UM
- IPM. Nota. 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.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExpirationDateOption
Il parametro ExpirationDateOption specifica se la data di scadenza viene calcolata dalla data di creazione del contenuto o dalla data dell'ultima modifica. I valori validi sono:
- CreationAgeInDays
- ModificationAgeInDays
Non è possibile usare questo parametro per le regole di conservazione di Teams.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Il parametro Identity consente di specificare la regola di conservazione che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi la regola in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Type: | ComplianceRuleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetentionComplianceAction
Il parametro RetentionComplianceAction specifica l'azione di conservazione per la regola. I valori validi sono:
- Elimina
- Conservare
- KeepAndDelete
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 Days, Months o Years.
- 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.
| Type: | HoldDurationHint |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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: | Security & Compliance |