New-RetentionComplianceRule

Sintassi

ComplianceTag

New-RetentionComplianceRule
    -ApplyComplianceTag <String>
    -Policy <PolicyIdParameter>
    [-ContentContainsSensitiveInformation <PswsHashtable[]>]
    [-Confirm]
    [-ContentMatchQuery <String>]
    [-ExpirationDateOption <String>]
    [-IRMRiskyUserProfiles <String>]
    [-MachineLearningModelIDs <MultiValuedProperty>]
    [-PriorityCleanup]
    [-RetentionComplianceAction <String>]
    [-WhatIf]
    [<CommonParameters>]

Default

New-RetentionComplianceRule
    [-Name] <String>
    -Policy <PolicyIdParameter>
    [-Comment <String>]
    [-ExcludedItemClasses <MultiValuedProperty>]
    [-RetentionDuration <Unlimited>]
    [-RetentionDurationDisplayHint <HoldDurationHint>]
    [-Confirm]
    [-ContentMatchQuery <String>]
    [-ExpirationDateOption <String>]
    [-PriorityCleanup]
    [-RetentionComplianceAction <String>]
    [-WhatIf]
    [<CommonParameters>]

PublishComplianceTag

New-RetentionComplianceRule
    -Policy <PolicyIdParameter>
    -PublishComplianceTag <String>
    [-Confirm]
    [-ExpirationDateOption <String>]
    [-PriorityCleanup]
    [-RetentionComplianceAction <String>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Esempio

Esempio 1

New-RetentionComplianceRule -Name InternalCompanyRule -Policy "Internal Company Policy" -RetentionDuration Unlimited -RetentionComplianceAction Keep

Esempio 2

New-RetentionComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -RetentionDuration 365 -RetentionComplianceAction KeepAndDelete -ExpirationDateOption ModificationAgeInDays

Parametri

-ApplyComplianceTag

Applicabile: Sicurezza & conformità

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.

Proprietà dei parametri

Set di parametri

-Comment

Applicabile: Sicurezza & conformità

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".

Proprietà dei parametri

Set di parametri

-Confirm

Applicabile: Sicurezza & conformità

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma 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, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Set di parametri

-ContentContainsSensitiveInformation

Applicabile: Sicurezza & conformità

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.

Proprietà dei parametri

Set di parametri

-ContentMatchQuery

Applicabile: Sicurezza & conformità

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 di Keyword Query Language (KQL) e Query chiave e condizioni di ricerca per eDiscovery.

Non è possibile usare questo parametro per le regole di conservazione di Teams.

Proprietà dei parametri

Set di parametri

-ExcludedItemClasses

Applicabile: Sicurezza & conformità

Il parametro ExcludedItemClasses consente di specificare i tipi di messaggi da escludere dalla regola. È possibile usare questo parametro solo per escludere elementi da un criterio di attesa, che esclude la classe di elementi specificata dal contenuto. L'uso di questo parametro non esclude gli elementi dai criteri di eliminazione. In genere, si usa questo parametro per escludere messaggi vocali, conversazioni di messaggistica istantanea e altri contenuti di Skype for Business Online da un criterio di blocco. I valori comuni di Skype for Business includono:

• IPM. Note.Microsoft.Conversation
• IPM. Note.Microsoft.Conversation.Voice
• IPM. Nota.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

È inoltre possibile specificare classi di messaggi per gli elementi di Exchange e classi di messaggi personalizzate o non Microsoft. I valori specificati non vengono convalidati, quindi il parametro accetta qualsiasi valore di testo.

È possibile specificare più valori di classe di elementi utilizzando la sintassi seguente: "Value1","Value2",..."ValueN".

Non è possibile usare questo parametro per le regole di conservazione di Teams.

Proprietà dei parametri

Set di parametri

-ExpirationDateOption

Applicabile: Sicurezza & conformità

Il parametro ExpirationDateOption consente di specificare 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.

Proprietà dei parametri

Set di parametri

-IRMRiskyUserProfiles

Applicabile: Sicurezza & conformità

{{ Fill IRMRiskyUserProfiles Description }}

Proprietà dei parametri

Set di parametri

-MachineLearningModelIDs

Applicabile: Sicurezza & conformità

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Set di parametri

-Name

Applicabile: Sicurezza & conformità

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.

Proprietà dei parametri

Set di parametri

-Policy

Applicabile: Sicurezza & conformità

Il parametro Policy consente di specificare il criterio che deve contenere la regola.

Proprietà dei parametri

Set di parametri

-PriorityCleanup

Applicabile: Sicurezza & conformità

L'opzione PriorityCleanup specifica se creare una regola associata a un criterio di pulizia della priorità. Con questa opzione non è necessario specificare alcun valore.

I criteri di pulizia prioritaria accelerano l'eliminazione del contenuto riservato sostituendo le impostazioni di conservazione esistenti o i blocchi di eDiscovery. Per ulteriori informazioni, consulta Pulizia priorità.

Proprietà dei parametri

Set di parametri

-PublishComplianceTag

Applicabile: Sicurezza & conformità

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 criteri di collegamento nel cloud.

Proprietà dei parametri

Set di parametri

-RetentionComplianceAction

Applicabile: Sicurezza & conformità

Il parametro RetentionComplianceAction consente di specificare 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". Questo parametro è obbligatorio per evitare cancellazioni non conformi.

Proprietà dei parametri

Set di parametri

-RetentionDuration

Applicabile: Sicurezza & conformità

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 è conservato a tempo indeterminato.

Proprietà dei parametri

Set di parametri

-RetentionDurationDisplayHint

Applicabile: Sicurezza & conformità

Il parametro RetentionDurationDisplayHint consente di specificare le unità utilizzate 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 visualizza 1 anno come durata del mantenimento del contenuto.

Non è possibile usare questo parametro per le regole di conservazione di Teams.

Proprietà dei parametri

Set di parametri

-WhatIf

Applicabile: Sicurezza & conformità

Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.

Proprietà dei parametri

Set di parametri

CommonParameters