Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

New-RetentionComplianceRule

 

S’applique à :Office 365 Security & Compliance Center

Dernière rubrique modifiée :2017-07-13

Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité dans Office 365. Pour plus d’informations, consultez la rubrique PowerShell pour le Centre de conformité d’Office 365.

Utilisez la cmdlet New-RetentionComplianceRule pour créer des règles de rétention dans le Centre de conformité et sécurité.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

New-RetentionComplianceRule -Name <String> -Policy <PolicyIdParameter> [-Comment <String>] [-ContentMatchQuery <String>] [-ExcludedItemClasses <MultiValuedProperty>] [-RetentionDuration <Unlimited>] [-RetentionDurationDisplayHint <Days | Months | Years>] <COMMON PARAMETERS>

New-RetentionComplianceRule -ApplyComplianceTag <String> -Policy <PolicyIdParameter> [-ContentContainsSensitiveInformation <PswsHashtable[]>] [-ContentMatchQuery <String>] <COMMON PARAMETERS>

New-RetentionComplianceRule -Policy <PolicyIdParameter> -PublishComplianceTag <String> <COMMON PARAMETERS>

New-RetentionComplianceRule -Policy <PolicyIdParameter> <COMMON PARAMETERS>

COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-ExpirationDateOption <String>] [-RetentionComplianceAction <String>] [-WhatIf [<SwitchParameter>]]

Cet exemple crée une nouvelle règle de rétention nommée SeptOneYear et l’ajoute à la stratégie de rétention existant nommée « Politique interne de la société ». Contenu se tiendra indéfiniment.

New-RetentionComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -RetentionDuration Unlimited

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.

Des autorisations doivent vous avoir été attribuées dans le Centre de conformité et sécurité dans Office 365 pour que vous puissiez utiliser cette cmdlet. Pour plus d’informations, consultez la rubrique Autorisations dans le Centre de sécurité et conformité Office 365.

 

Paramètre Obligatoire Type Description

ApplyComplianceTag

Obligatoire

System.String

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, placez-la 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.

name

Obligatoire

System.String

Le paramètre Name permet de définir un nom unique pour la règle de rétention. Si la valeur contient des espaces, placez-la entre guillemets.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ApplyComplianceTag ou PublishComplianceTag.

Policy

Obligatoire

Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter

Le paramètre Policy permet de définir la stratégie qui doit contenir la règle.

PublishComplianceTag

Obligatoire

System.String

Le paramètre PublishComplianceTag permet de définir l’étiquette qui est publiée pour la règle, ce qui rend l’étiquette visible par 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, placez-la 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 ApplyComplianceTag.

Comment

Facultatif

System.String

Le paramètre Comment permet d’insérer un commentaire. Si la valeur que vous saisissez contient des espaces, insérez des guillemets ("). Par exemple : "This is an admin note".

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

ContentContainsSensitiveInformation

Facultatif

Microsoft.Office.CompliancePolicy.Tasks.PswsHashtable[]

Le paramètre ContentContainsSensitiveInformation spécifie une condition pour la règle qui repose sur une correspondance de type d’informations sensibles dans le contenu. La règle est appliquée au contenu qui contient 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 de détails sur les types d’informations sensibles, consultez la rubrique Inventaire des types d’informations sensibles.

Vous pouvez utiliser ce paramètre avec le paramètre ApplyComplianceTag.

ContentMatchQuery

Facultatif

System.String

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 sur la syntaxe KQL, consultez la rubrique Référence de syntaxe de langage de requête de mot clé (KQL).

ExcludedItemClasses

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

VALEUR_PARAMÈTRE : MultiValuedProperty

ExpirationDateOption

Facultatif

System.String

Le paramètre ExpirationDateOption indique si la date d’expiration est calculée à partir de la date de création de contenu ou de la date de la dernière modification. Les valeurs valides sont les suivantes :

  • CreationAgeInDays

  • ModificationAgeInDays

RetentionComplianceAction

Facultatif

System.String

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

  • Méthode delete

  • Keep

  • KeepAndDelete

RetentionDuration

Facultatif

Microsoft.Exchange.Data.Unlimited

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 :

  • An integer   Durée de conservation en jours.

  • Unlimited   Le contenu est conservé indéfiniment.

RetentionDurationDisplayHint

Facultatif

Microsoft.Office.CompliancePolicy.PolicyEvaluation.HoldDurationHint

Le paramètre RetentionDurationDisplayHint permet de définir les unités utilisées pour afficher la durée de rétention dans le Centre de conformité et sécurité. Les valeurs valides sont les suivantes :

  • Days

  • Months

  • Years

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 Centre de conformité et sécurité affiche 1 an comme durée de conservation du contenu.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: