New-ManagedContentSettings
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.
Les valeurs de paramètres valides pour les classes de message personnalisées comprennent :
|
||
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 :
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"