Partager via


Set-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 Set-RetentionComplianceRule pour modifier les règles de rétention existantes 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

Set-RetentionComplianceRule
   [-Identity] <ComplianceRuleIdParameter>
   [-ApplyComplianceTag <String>]
   [-Comment <String>]
   [-Confirm]
   [-ContentContainsSensitiveInformation <PswsHashtable[]>]
   [-ContentDateFrom <DateTime>]
   [-ContentDateTo <DateTime>]
   [-ContentMatchQuery <String>]
   [-ExcludedItemClasses <MultiValuedProperty>]
   [-ExpirationDateOption <String>]
   [-IRMRiskyUserProfiles <String>]
   [-PriorityCleanup]
   [-RetentionComplianceAction <String>]
   [-RetentionDuration <Unlimited>]
   [-RetentionDurationDisplayHint <HoldDurationHint>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

Set-RetentionComplianceRule -Identity "Internal Company Rule" -RetentionDuration 180 -RetentionDurationDisplayHint Days

Cet exemple modifie la durée de conservation pour la règle de rétention nommée « Internal Company Rule ».

Paramètres

-ApplyComplianceTag

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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-Comment

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-Confirm

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.
Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-ContentContainsSensitiveInformation

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 ne pouvez pas utiliser ce paramètre pour les règles de rétention Teams.

Type:PswsHashtable[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-ContentDateFrom

Le paramètre ContentDateFrom spécifie la date de début de la plage de dates pour le contenu à inclure.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-ContentDateTo

Le paramètre ContentDateTo spécifie la date de fin de la plage de dates pour le contenu à inclure.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-ContentMatchQuery

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 KQL (Keyword Query Language) 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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-ExcludedItemClasses

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 tierces. Notez que 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.

Type:MultiValuedProperty
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-ExpirationDateOption

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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-Identity

Le paramètre Identity spécifie la règle de rétention à modifier. Vous pouvez utiliser une valeur quelconque qui identifie distinctement la règle. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID
Type:ComplianceRuleIdParameter
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-IRMRiskyUserProfiles

{{ Fill IRMRiskyUserProfiles Description }}

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-PriorityCleanup

{{ Fill PriorityCleanup Description }}

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-RetentionComplianceAction

Le paramètre RetentionComplianceAction spécifie l’action de rétention pour la règle. Les valeurs valides sont les suivantes :

  • Supprimer
  • Conserver
  • KeepAndDelete
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-RetentionDuration

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.
Type:Unlimited
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-RetentionDurationDisplayHint

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 Days, Months ou Years.

  • Jours
  • Mois
  • Années

Par exemple, si ce paramètre est défini sur la valeur Years et que le paramètre RetentionDuration est défini sur 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.

Type:HoldDurationHint
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance

-WhatIf

Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False
S’applique à:Security & Compliance