New-ManagedContentSettings

Cette applet de commande est disponible uniquement dans Exchange Server 2010.

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

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

Syntax

New-ManagedContentSettings
   [-Name] <String>
   -FolderName <ELCFolderIdParameter>
   -MessageClass <String>
   [-AddressForJournaling <RecipientIdParameter>]
   [-AgeLimitForRetention <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-JournalingEnabled <Boolean>]
   [-LabelForJournaling <String>]
   [-MessageFormatForJournaling <JournalingFormat>]
   [-MoveToDestinationFolder <ELCFolderIdParameter>]
   [-RetentionAction <RetentionAction>]
   [-RetentionEnabled <Boolean>]
   [-TriggerForRetention <RetentionDateType>]
   [-WhatIf]
   [<CommonParameters>]

Description

Les paramètres de contenu géré sont associés aux dossiers gérés pour contrôler la durée de vie des éléments présents dans les boîtes aux lettres des 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, externe à la boîte aux lettres.

Pour plus d’informations sur les paramètres de contenu managé, consultez Gestion des enregistrements de messagerie.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered

Cet exemple crée des paramètres de contenu géré pour le dossier par défaut géré Exec-DeletedItems. Lorsqu’ils sont ajoutés à une stratégie de boîte aux lettres de dossier géré et appliqués à une boîte aux lettres, les éléments du dossier Éléments supprimés seront définitivement supprimés 30 jours après la date de remise.

Exemple 2

New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180

Cet exemple crée des paramètres de contenu géré CS-Exec-Calendar pour la classe de message Calendar. 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 180 jours.

Paramètres

-AddressForJournaling

Le paramètre AddressForJournaling spécifie le destinataire de journalisation où les messages journalisés sont envoyés. Vous pouvez utiliser une valeur quelconque qui identifie le destinataire. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Nom unique canonique
  • GUID

Ce paramètre est obligatoire si le paramètre JournalingEnabled est défini sur $true.

Type:RecipientIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-AgeLimitForRetention

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.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

Le commutateur Confirme 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 applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-DomainController

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-FolderName

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.

Type:ELCFolderIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-JournalingEnabled

Le paramètre JournalingEnabled spécifie que la journalisation est activée lorsqu’il est défini sur $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-LabelForJournaling

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MessageClass

Le paramètre MessageClass spécifie le type de message auquel des paramètres de configuration d’expiration et de journalisation dans ces paramètres de contenu s’appliquent.

La valeur du paramètre peut être un type de message connu tel que Éléments du calendrier ou une classe de message spécifique telle que IPM.NOTE.SMIME ou une classe de message personnalisée. Vous pouvez utiliser les types de messages connus suivants :

  • Pour Tout le contenu de la boîte aux lettres, utilisez la valeur *.
  • Pour le type de message Éléments du 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ément(s)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*.

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 de la classe de message. Par exemple, IPM. REMARQUE* (inclut IPM. REMARQUE et toutes les sous-classes) ou IPM. REMARQUE.* (inclut les sous-classes pour IPM. REMARQUE, mais pas IPM. REMARQUE elle-même). *. NOTE et IPM.*. REMARQUE ne sont pas des valeurs valides.

Remarques :

  • Lorsque des caractères génériques sont utilisés, ces stratégies s’appliquent uniquement aux classes de message ne disposant pas d’un paramètre de contenu spécifique. Par conséquent, IPM.NOTE.SMIME remplace IPM.NOTE.*.
  • Des paramètres spécifiques remplacent les paramètres généraux, par exemple, la messagerie vocale remplace AllMailboxContent.
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MessageFormatForJournaling

Le paramètre MessageFormatForJournaling spécifie le format de message à utiliser pour journaliser un élément. Vous pouvez utiliser les valeurs suivantes :

  • UseMsg Outlook .msg format
  • UseTnef Outlook MAPI format
Type:JournalingFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MoveToDestinationFolder

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 que la valeur du paramètre RetentionAction est définie sur MoveToFolder, une erreur est renvoyée.

Type:ELCFolderIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Name

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RetentionAction

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.

Type:RetentionAction
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RetentionEnabled

Le paramètre RetentionEnabled indique que la rétention est activée lorsqu’il est défini sur $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-TriggerForRetention

Le paramètre TriggerForRetention spécifie la date considérée 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.

Les valeurs valides sont les suivantes :

  • WhenDelivered
  • WhenMoved

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.

Type:RetentionDateType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

Entrées

Input types

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.

Sorties

Output types

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.