Set-ManagedContentSettings

 

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

Dernière rubrique modifiée : 2007-10-08

La cmdlet Set-ManagedContentSettings permet de modifier des paramètres de contenu géré

Syntaxe

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

Set-ManagedContentSettings [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <ElcContentSettings>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-Name <String>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-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. 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 Set-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.

Notes

Si la cmdlet New-ManagedContentSettings a le paramètre MessageClass, la commande Set-ManagedContentSettings ne l'a pas. Pour modifier le type de message auquel s'appliquent les paramètres de contenu, vous devez supprimer, puis recréer les paramètres de contenu. Pour plus d'informations sur le paramètre MessageClass, consultez la rubrique New-ManagedContentSettings.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.ELCContentSettingsIdParameter

Le paramètre Identity spécifie le nom, le nom unique ou le GUID de la stratégie de boîte aux lettres de dossier 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.

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 à partir du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.ElcContentSettings

Le paramètre Instance spécifie l'identité des paramètres de contenu de dossier géré.

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 nom du dossier de destination d'une action de rétention.

Name

Facultatif

System.String

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

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.

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 si l'élément 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 cet exemple, la commande Set-ManagedContentSettings permet de spécifier l'adresse de l'espace de stockage destination de l'opération de journalisation.

Set-ManagedContentSettings -Identity MyManagedContentSettings -AddressForJournaling MySmtpAddress@contoso.com