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-HoldComplianceRule

 

S’applique à :Office 365 Security & Compliance Center

Dernière rubrique modifiée :2017-04-21

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.

L’applet de commande New-HoldComplianceRule permet de créer de nouvelles règles de conservation dans le Centre de conformité et sécurité.

noteRemarque :
L’applet de commande New-HoldComplianceRule a été remplacé par l’applet de commande New-RetentionComplianceRule . Si vous avez des scripts qui utilisent l’applet de commande New-HoldComplianceRule , les mettre à jour pour utiliser l’applet de commande New-RetentionComplianceRule .

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

New-HoldComplianceRule -Name <String> -Policy <PolicyIdParameter> [-Comment <String>] [-ContentDateFrom <DateTime>] [-ContentDateTo <DateTime>] [-ContentMatchQuery <String>] [-Disabled <$true | $false>] [-HoldContent <Unlimited>] [-HoldDurationDisplayHint <Days | Months | Years>] <COMMON PARAMETERS>

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

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

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

COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Cet exemple crée une règle de conservation nommée SeptOneYear et l’ajoute à la stratégie de conservation nommée Internal Company Policy. Le contenu créé ou mis à jour entre les dates spécifiées est conservé indéfiniment.

New-HoldComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -ContentDateFrom "09/10/14 5:00 PM" -ContentDateTo "09/10/15 5:00 PM" -HoldContent Unlimited

La règle de conservation doit être ajoutée à une stratégie de conservation existante à l’aide du paramètre Policy. Vous ne pouvez ajouter qu’une seule règle à chaque stratégie de conservation.

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

name

Obligatoire

System.String

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

Policy

Obligatoire

Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter

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

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.

ContentDateFrom

Facultatif

System.DateTime

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 qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

ContentDateTo

Facultatif

System.DateTime

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 qui est défini dans les paramètres Options régionales de l’ordinateur sur lequel vous exécutez la commande. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte dd/mm/yyyy, entrez 01/09/2015 pour spécifier le 1er septembre 2015. Vous pouvez entrer la date uniquement, ou la date et l’heure de la journée. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets («  »), par exemple « 01/09/2015 17:00 ».

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

Disabled

Facultatif

System.Boolean

Le paramètre Disabled indique si la règle de conservation est activée ou désactivée. L’entrée valide pour ce paramètre est $true ou $false. La valeur par défaut est $false.

HoldContent

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre HoldContent permet de définir la durée de conservation pour la règle. Les valeurs valides sont les suivantes :

  • An integer   Durée de conservation en jours.

  • Unlimited   Le contenu est conservé indéfiniment.

HoldDurationDisplayHint

Facultatif

Microsoft.Office.CompliancePolicy.PolicyEvaluation.HoldDurationHint

Le paramètre HoldDurationDisplayHint spécifie les unités utilisées pour afficher la durée de conservation dans le Centre de conformité et sécurité. Les valeurs valides sont :

  • Days

  • Months

  • Years

Par exemple, si ce paramètre est défini sur la valeur Years, et le paramètre HoldContent est défini à la valeur 365, la Centre de conformité et sécurité affiche 1 an que durée de détenir le 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: