New-RetentionComplianceRule
Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité PowerShell. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et sécurité PowerShell.
Utilisez l’applet de commande New-RetentionComplianceRule pour créer des règles de rétention dans le portail de conformité Microsoft Purview.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
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>]
Description
La règle de rétention doit être ajoutée à une stratégie de rétention existante à l’aide du paramètre Policy. Vous ne pouvez ajouter qu’une seule règle à chaque stratégie de rétention.
Pour pouvoir utiliser cette cmdlet dans le Centre de sécurité et de conformité PowerShell, des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 1
New-RetentionComplianceRule -Name InternalCompanyRule -Policy "Internal Company Policy" -RetentionDuration Unlimited -RetentionComplianceAction Keep
Cet exemple crée une règle de conservation de rétention nommée InternalCompanyRule et l’ajoute à la stratégie de conservation de rétention existante nommée « Stratégie d’entreprise interne ». Le contenu est conservé indéfiniment.
Exemple 2
New-RetentionComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -RetentionDuration 365 -RetentionComplianceAction KeepAndDelete -ExpirationDateOption ModificationAgeInDays
Cet exemple crée une règle de rétention nommée SeptOneYear et l’ajoute à la stratégie de rétention existante nommée « Stratégie d’entreprise interne ». Le contenu est conservé pendant un an à partir du jour où le contenu a été modifié pour la dernière fois avant sa suppression.
Paramètres
-ApplyComplianceTag
Applicable : Sécurité & Conformité
Le paramètre ApplyComplianceTag spécifie l’étiquette qui est appliquée aux messages électroniques ou aux documents par la règle (ce qui modifie la durée de conservation du contenu). Ce paramètre doit avoir pour valeur le nom d’une étiquette existante. Si la valeur contient des espaces, mettez le nom entre guillemets.
Vous visualisez et créez des étiquettes à l’aide des cmdlets Get-ComplianceTag et New-ComplianceTag.
Vous ne pouvez pas utiliser ce paramètre avec les paramètres Name ou PublishComplianceTag.
Vous ne pouvez pas utiliser ce paramètre pour les règles de rétention Teams.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ComplianceTag
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Comment
Applicable : Sécurité & Conformité
Le paramètre Comment permet d’insérer un commentaire facultatif. Si la valeur que vous saisissez contient des espaces, placez-la entre guillemets ("). Par exemple : "Ceci est une note d’administration".
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Default
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Sécurité & Conformité
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ContentContainsSensitiveInformation
Applicable : Sécurité & Conformité
Le paramètre ContentContainsSensitiveInformation spécifie une condition pour la règle basée sur une correspondance de type d'informations sensibles dans le contenu. La règle est appliquée au contenu contenant le type d’informations sensibles spécifié.
Ce paramètre utilise la syntaxe de base @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...). Par exemple : @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).
Utilisez la cmdlet Get-DLPSensitiveInformationType pour répertorier les types d’informations sensibles pour votre organisation. Pour plus d’informations sur les types d’informations sensibles, consultez Ce que recherchent les types d’informations sensibles dans Exchange.
Vous pouvez utiliser ce paramètre avec le paramètre ApplyComplianceTag.
Vous ne pouvez pas utiliser ce paramètre pour les règles de rétention Teams.
Propriétés du paramètre
| Type: | PswsHashtable[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ComplianceTag
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ContentMatchQuery
Applicable : Sécurité & Conformité
Le paramètre ContentMatchQuery spécifie un filtre de recherche de contenu.
Ce paramètre utilise une chaîne de recherche de texte ou une requête formatée en utilisant la syntaxe KQL (Keyword Query Language). Pour plus d’informations, consultez Informations de référence sur la syntaxe Langage de requête par mots-clés (KQL) et Requêtes par mot clé et conditions de recherche pour eDiscovery.
Vous ne pouvez pas utiliser ce paramètre pour les règles de rétention Teams.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ComplianceTag
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
Default
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExcludedItemClasses
Applicable : Sécurité & Conformité
Le paramètre ExcludedItemClasses spécifie les types de messages à exclure de la règle. Vous pouvez utiliser ce paramètre uniquement pour exclure des éléments d’une stratégie de conservation, ce qui exclut la classe d’élément spécifiée de la conservation. L’utilisation de ce paramètre n’exclut pas les éléments des stratégies de suppression. En règle générale, vous utilisez ce paramètre pour exclure les messages vocaux, les conversations par messagerie instantanée et d’autres contenus Skype Entreprise Online d’être conservés par une stratégie de conservation. Les valeurs Skype Entreprise courantes sont les suivantes :
- 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. Remarque.Microsoft.Voicemail.UM
- IPM.Note.Microsoft.Voicemail.UM.CA
En outre, vous pouvez spécifier des classes de message pour les éléments Exchange et les classes de message personnalisées ou non-Microsoft. Les valeurs que vous spécifiez ne sont pas validées. Le paramètre accepte donc n’importe quelle valeur de texte.
Vous pouvez spécifier plusieurs valeurs de classe d’élément à l’aide de la syntaxe suivante : "Value1","Value2",..."ValueN".
Vous ne pouvez pas utiliser ce paramètre pour les règles de rétention Teams.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Default
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExpirationDateOption
Applicable : Sécurité & Conformité
Le paramètre ExpirationDateOption spécifie si la date d’expiration est calculée à partir de la date de création du contenu ou de la date de la dernière modification. Les valeurs valides sont les suivantes :
- CreationAgeInDays
- ModificationAgeInDays
Vous ne pouvez pas utiliser ce paramètre pour les règles de rétention Teams.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IRMRiskyUserProfiles
Applicable : Sécurité & Conformité
{{ Fill IRMRiskyUserProfiles Description }}
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ComplianceTag
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MachineLearningModelIDs
Applicable : Sécurité & Conformité
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ComplianceTag
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Sécurité & Conformité
Le paramètre Name permet de définir un nom unique pour la règle de rétention. Si la valeur contient des espaces, mettez le nom entre guillemets.
Vous ne pouvez pas utiliser ce paramètre avec les paramètres ApplyComplianceTag ou PublishComplianceTag.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Default
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Policy
Applicable : Sécurité & Conformité
Le paramètre Policy permet de définir la stratégie qui doit contenir la règle.
Propriétés du paramètre
| Type: | PolicyIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PriorityCleanup
Applicable : Sécurité & Conformité
Le commutateur PriorityCleanup spécifie s’il faut créer une règle associée à une stratégie de nettoyage de priorité. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Les stratégies de nettoyage de priorité accélèrent la suppression du contenu sensible en remplaçant les paramètres de rétention existants ou les conservations eDiscovery. Pour plus d’informations, consultez Nettoyage de priorité.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PublishComplianceTag
Applicable : Sécurité & Conformité
Le paramètre PublishComplianceTag spécifie l’étiquette publiée pour la règle, ce qui rend l’étiquette visible pour les utilisateurs dans les applications (par exemple, Outlook, SharePoint et OneDrive). Ce paramètre doit avoir pour valeur le nom d’une étiquette existante. Si la valeur contient des espaces, mettez le nom entre guillemets.
Vous visualisez et créez des étiquettes à l’aide des cmdlets Get-ComplianceTag et New-ComplianceTag.
Vous ne pouvez pas utiliser ce paramètre dans les scénarios suivants :
- Avec les paramètres Name ou ApplyComplianceTag.
- Pour les règles de rétention Teams.
- Avec des stratégies de pièces jointes cloud.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
PublishComplianceTag
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetentionComplianceAction
Applicable : Sécurité & Conformité
Le paramètre RetentionComplianceAction spécifie l’action de rétention pour la règle. Les valeurs valides sont les suivantes :
- Supprimer
- Conserver
- KeepAndDelete
Si vous n’utilisez pas ce paramètre, la stratégie de rétention est créée en tant que stratégie « UniH » au lieu d’une stratégie « mbx ». Ce paramètre est obligatoire pour empêcher la suppression non conforme.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetentionDuration
Applicable : Sécurité & Conformité
Le paramètre RetentionDuration permet de définir la durée de conservation pour la règle de rétention. Les valeurs valides sont les suivantes :
- Entier : durée de conservation en jours.
- Illimité : le contenu est conservé indéfiniment.
Propriétés du paramètre
| Type: | Unlimited |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Default
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetentionDurationDisplayHint
Applicable : Sécurité & Conformité
Le paramètre RetentionDurationDisplayHint spécifie les unités utilisées pour afficher la durée de rétention dans le portail de conformité Microsoft Purview. Les valeurs valides sont les suivantes :
- Jours
- Mois
- Années
Par exemple, si ce paramètre est défini sur la valeur Years et que le paramètre RetentionDuration a la valeur 365, le portail de conformité Microsoft Purview affiche 1 an comme durée de conservation du contenu.
Vous ne pouvez pas utiliser ce paramètre pour les règles de rétention Teams.
Propriétés du paramètre
| Type: | HoldDurationHint |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Default
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Sécurité & Conformité
Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.