New-ManagedContentSettings

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2009-09-16

La cmdlet New-ManagedContentSettings permet de créer des paramètres de contenu géré pour des dossiers gérés.

Syntaxe

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les paramètres de contenu géré sont ceux que vous appliquez à des dossiers gérés pour contrôler la durée de vie des éléments se trouvant dans les boîtes aux lettres d'utilisateurs. La durée de vie est contrôlée comme suit :

  • en contrôlant la rétention de contenu et en supprimant le contenu superflu ;

  • en journalisant automatiquement le contenu important dans un emplacement de stockage distinct, séparé de la boîte aux lettres.

Pour plus d'informations sur les paramètres de contenu géré, consultez la rubrique Gestion des enregistrements de messagerie.

Pour exécuter la cmdlet New-ManagedContentSettings, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur d'organisation Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

FolderName

Obligatoire

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Le paramètre FolderName spécifie le nom ou le GUID du dossier géré auquel les paramètres de contenu géré s'appliquent.

MessageClass

Obligatoire

System.String

Le paramètre MessageClass spécifie le type de message auquel des paramètres de configuration d'expiration et de journalisation à l'intérieur de ces paramètres de contenu s'appliquent.

  • La valeur du paramètre doit être une classe de message spécifique, telle que IPM.NOTE.SMIME ou une classe de message personnalisée.

Les valeurs de paramètres valides pour les classes de message personnalisées comprennent :

  • une classe de message spécifique (par exemple, IPM.NOTE) ;

  • le caractère générique astérisque (*), qui indique que les paramètres de contenu s’appliquent à toutes les classes de message ;

  • une classe de message spécifique contenant le caractère générique astérisque. Le caractère générique astérisque doit apparaître comme le dernier caractère dans la classe de message.

    Exemples :

    • IPM.NOTE* (Ceci comprend IPM.NOTE et toutes les sous-classes.)

    • IPM.NOTE.* (Ceci comprend les sous-classes pour IPM.NOTE mais pas IPM.NOTE.)

    • *.NOTE et IPM.*.NOTE ne sont pas acceptables.

> [!Note] > Lorsque des caractères génériques sont utilisés, ces stratégies s’appliquent uniquement aux classes de messages ne disposant pas d’un paramètre de contenu spécifique. Par conséquent, IPM.NOTE.SMIME remplace IPM.NOTE.*
noteRemarque :
Les paramètres spécifiques prédominent sur les paramètres généraux. Par exemple, la Messagerie vocale prédomine sur Tout le contenu de la boîte aux lettres.
La liste suivante décrit les types de messages connus et indique les valeurs qui doivent être utilisées :

  • Pour le type de message Tout le contenu de la boîte aux lettres, utilisez la valeur *.

  • Pour le type de message Éléments Calendrier, utilisez la valeur IPM.Appointment*.

  • Pour le type de message Contacts, utilisez la valeur IPM.Contact*.

  • Pour le type de message Documents, utilisez la valeur IPM.Document*.

  • Pour le type de message Télécopies, utilisez la valeur IPM.Note.Microsoft.Fax.

  • Pour le type de message Éléments Journal, utilisez la valeur IPM.Activity.

  • Pour le type de message Demandes de réunion, réponses et annulations, utilisez la valeur IPM.Schedule*.

  • Pour le type de message Notes, utilisez la valeur IPM.StickyNote.

  • Pour le type de message Publications, utilisez la valeur IPM.Post.

  • Pour le type de message Éléments RSS, utilisez la valeur IPM.Post.RSS.

  • Pour le type de message Tâches, utilisez la valeur IPM.Task*.

  • Pour le type de message Messagerie vocale, utilisez la valeur IPM.Note.Microsoft.Voicemail*.

Name

Obligatoire

System.String

Le paramètre Name spécifie un nom unique pour les paramètres de contenu géré.

AddressForJournaling

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Le paramètre AddressForJournaling spécifie l'adresse de l'espace de stockage destination de l'opération de journalisation. Si ce paramètre est absent et si le paramètre JournalingEnabled est défini sur $true, une erreur est renvoyée.

AgeLimitForRetention

Facultatif

System.Nullable

Le paramètre AgeLimitForRetention spécifie l'âge auquel la rétention est appliquée à un élément. La limite d'âge correspond au nombre de jours écoulés depuis la date de remise de l'élément ou la date de création d'un élément non remis. Si ce paramètre est absent et si le paramètre RetentionEnabled est défini sur $true, une erreur est renvoyée.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ces informations de configuration au service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

JournalingEnabled

Facultatif

System.Boolean

Le paramètre JournalingEnabled indique que la journalisation est activée lorsqu'elle est définie sur $true.

LabelForJournaling

Facultatif

System.String

Le paramètre LabelForJournaling spécifie une étiquette qui sera associée à un élément. Cette étiquette sera utilisée par la banque de destination pour déterminer le contenu de l'élément et appliquer la stratégie appropriée.

MessageFormatForJournaling

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

Le paramètre MessageFormatForJournaling permet à l'administrateur de spécifier qu'un élément doit être journalisé au format Microsoft Outlook .msg ou au format MAPI Outlook traditionnel.

MoveToDestinationFolder

Facultatif

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Le paramètre MoveToDestinationFolder spécifie le dossier de destination d'une action de déplacement.

Le dossier de destination doit être un dossier personnalisé géré existant. Si tel n'est pas le cas, une erreur est renvoyée. Si le paramètre MoveToDestinationFolder est absent et si l'action de rétention est MoveToFolder, une erreur est renvoyée.

RetentionAction

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

Le paramètre RetentionAction spécifie l'une des actions suivantes :

  • marquer comme limite de rétention passée ;

  • déplacer vers un dossier personnalisé géré ;

  • déplacer vers le dossier Éléments supprimés ;

  • supprimer et autoriser la récupération ;

  • supprimer définitivement.

Si ce paramètre est absent et si le paramètre RetentionEnabled est défini sur $true, une erreur est renvoyée.

RetentionEnabled

Facultatif

System.Boolean

Le paramètre RetentionEnabled indique que la rétention est activée lorsqu'elle est définie sur $true.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni au paramètre TemplateInstance, la commande utilise la configuration de cet objet pour créer une copie de celui-ci sur un serveur local ou cible.

TriggerForRetention

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

Le paramètre TriggerForRetention indique la date à utiliser comme date de début de la période de rétention. Un élément peut atteindre sa limite de rétention un certain nombre de jours après sa remise ou après son déplacement vers un dossier spécifique.

Cette valeur correspond au bit 0x4 de l'attribut msExchELCFlags dans Active Directory. L'indicateur est défini sur $true si l'élément doit expirer en fonction de la date de son déplacement et sur $false s'il doit expirer en fonction de la date de remise. Si ce paramètre est absent et si le paramètre RetentionEnabled est défini sur $true, une erreur est renvoyée.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

  

Exceptions

Exceptions Description

  

Exemple

Dans le premier exemple, la commande New-ManagedContentSettings permet de créer des paramètres de contenu géré de la classe de message Calendar et nommés MyCalendarContentSettings. Les paramètres de contenu géré s'appliquent au calendrier du dossier par défaut. La rétention est activée et les éléments sont déplacés vers le dossier Éléments supprimés après 30 jours.

Dans le second exemple, les stubs (d’une classe de message personnalisée nommée IPM.Note.Archive.Shortcut) pour le contenu archivé dans les boîtes aux lettres utilisateurs sont supprimés avec le paramètre de contenu géré nommé RemoveArchiveStubs.

Pour plus d’informations sur les classes de message personnalisées, consultez la description du paramètre « MessageClass » dans cette rubrique et la section « À propos des classes de message » de l'article 241235 de la Base de connaissances Microsoft Comment modifier globalement les formulaires par défaut dans Outlook avec l’utilitaire Administrateur de formulaires.

New-ManagedContentSettings -FolderName Calendar -MessageClass Calendar -Name MyCalendarContentSettings -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "30"
New-ManagedContentSettings -FolderName Inbox -MessageClass IPM.Note.Archive.Shortcut -Name RemoveArchiveStubs -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "1"