New-ManagedFolder
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2010-11-29
La cmdlet New-ManagedFolder permet de créer des dossiers gérés pour la gestion des enregistrements de messagerie (MRM). Un dossier géré est un répertoire d'une boîte aux lettres d'utilisateur auquel la gestion des enregistrements de messagerie (MRM) a été appliquée. Voici les types de dossiers gérés :
Les dossiers par défaut gérés (tels que la Boîte de réception) apparaissent, par défaut, dans la boîte aux lettres Microsoft Office Outlook 2007 d'un utilisateur. Les dossiers par défaut gérés requièrent uniquement une licence d'accès client (CAL) Exchange Server standard.
Les dossiers personnalisés gérés sont créés par des administrateurs Exchange spécialement pour MRM. Les dossiers personnalisés gérés sont une fonctionnalité essentielle de la gestion des enregistrements de messagerie. Chaque boîte aux lettres avec des dossiers personnalisés gérés requiert une licence d'accès client à Exchange Server Enterprise.
La rétention et la journalisation des messages se trouvant dans des dossiers gérés sont contrôlées par les paramètres de contenu géré appliqués aux dossiers gérés.
Syntaxe
New-ManagedFolder -Name <String> -FolderName <String> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-StorageQuota <Unlimited>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
New-ManagedFolder -Name <String> -DefaultFolderType <Nullable> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet New-ManagedFolder permet de créer un dossier géré dans le service d'annuaire Active Directory. Ensuite, pour utiliser le nouveau dossier géré pour la gestion des enregistrements de messagerie :
Appliquez des paramètres de contenu géré au dossier.
Liez le dossier à une stratégie de boîte aux lettres de dossier géré.
Liez la stratégie de boîte aux lettres à la boîte aux lettres d'un utilisateur.
Exécutez l'Assistant de dossier géré, qui place le nouveau dossier géré dans la boîte aux lettres de l'utilisateur avec les paramètres que vous avez spécifiés.
Pour plus d'informations sur les opérations à effectuer pour implémenter la gestion des enregistrements de messagerie dans Microsoft Exchange Server 2007, consultez la rubrique Déploiement de la gestion des enregistrements de messagerie.
Par défaut, les dossiers personnalisés gérés sont créés avec cette cmdlet. Toutefois, vous pouvez également créer des copies supplémentaires des dossiers par défaut gérés en utilisant le paramètre DefaultFolderType pour spécifier le type de dossier par défaut à créer (par exemple, un dossier Boîte de réception supplémentaire). Lorsque vous créez de multiples copies d'un dossier par défaut géré, vous pouvez affecter des paramètres de contenu différents à chaque copie. Par exemple, vous pouvez disposer de deux dossiers Boîte de réception, l'un nommé InboxSixMonths et l'autre nommé InboxOneYear. Vous pouvez ensuite affecter une période de rétention de six mois au premier dossier et d'un an au second dossier à l'aide de la cmdlet New-ManagedContentSettings (ou à l'aide de l'Assistant Nouveaux paramètres de contenu géré de la console de gestion Exchange). Vous devez affecter un nom unique (à l'aide du paramètre Name) à chacun des dossiers par défaut gérés que vous créez. Toutefois, les utilisateurs voient toujours le nom du dossier par défaut non modifié. Dans l'exemple, que les utilisateurs disposent d'un dossier InboxSixMonths ou InboxOneYear, la Boîte de réception qu'ils voient dans leur boîte aux lettres sera intitulée Boîte de réception. Bien que les noms de dossiers que les utilisateurs voient dans leur boîte aux lettres puissent être réaffectés à des dossiers personnalisés gérés (à l'aide de la commande Set-ManagedFolder, paramètre FolderName), les noms de dossiers vus par les utilisateurs pour les dossiers par défaut gérés ne peuvent pas être modifiés.
Avant de commencer
Pour exécuter la cmdlet New-ManagedFolder, 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.
Cette commande n'accepte pas d'entrée en pipeline.
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
DefaultFolderType |
Obligatoire |
System.Nullable |
Le paramètre DefaultFolderType spécifie le type de dossier par défaut à créer (par exemple, un dossier Boîte de réception supplémentaire). Lorsque vous disposez de multiples copies d'un dossier par défaut, vous pouvez affecter des paramètres de contenu différents à chaque copie. Par exemple, vous pouvez avoir deux dossier Boîte de réception, l'un dont le contenu est conservé pendant un mois et l'autre dont le contenu est conservé pendant un an. Vous devez affecter un nom unique (à l'aide du paramètre Name) à chacun des dossiers par défaut gérés. Si aucune valeur n'est entrée pour le paramètre DefaultFolderType, un dossier personnalisé géré est créé. Les types de dossier que vous pouvez spécifier sont les suivants :
|
FolderName |
Obligatoire |
System.String |
Le paramètre FolderName spécifie le nom du dossier tel qu'il s'affiche dans les boîtes aux lettres des utilisateurs. Vous ne pouvez pas définir la valeur FolderName pour les dossiers par défaut gérés. Cette chaîne peut contenir jusqu'à 255 caractères. > [!Note] > Il ne faut pas confondre le paramètre FolderName avec le paramètre Name. |
Name |
Obligatoire |
System.String |
Le paramètre Name spécifie un nom unique pour le dossier. Cette valeur est utilisée par l'administrateur comme descripteur du dossier. Elle n'apparaît pas dans les boîtes aux lettres des utilisateurs. Cette chaîne peut contenir jusqu'à 65 caractères. > [!Note] > Il ne faut pas confondre le paramètre Name avec le paramètre FolderName. |
BaseFolderOnly |
Facultatif |
System.Boolean |
Le paramètre BaseFolderOnly permet d'empêcher l'Assistant Dossier géré d'appliquer une stratégie de boîte aux lettres au contenu des sous-dossiers du dossier géré. |
Comment |
Facultatif |
System.String |
Le paramètre Comment spécifie le commentaire par défaut de l'administrateur à afficher avec le dossier dans Microsoft Outlook 2007 et Outlook Web Access. Cette chaîne peut contenir jusqu'à 255 caractères. |
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 extrait des données depuis Active Directory, incluez le paramètre DomainController dans la commande. |
LocalizedComment |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Le paramètre LocalizedComment spécifie les commentaires de l'administrateur localisés et leurs langues. Des commentaires localisés sont affichés à la place du commentaire par défaut lorsque le paramétrage de la langue d'Outlook 2007 correspond à une langue spécifiée pour cette valeur de paramètre. Les commentaires doivent être au format ISOLanguageCode:Comment (par exemple, -LocalizedComment FR-FR : « Ceci est un commentaire localisé en français de France »). |
LocalizedFolderName |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Le paramètre LocalizedFolderName spécifie les noms de dossier localisés et leurs langues. Des noms de dossier localisés sont affichés à la place du nom de dossier par défaut lorsque le paramétrage de la langue d'Outlook 2007 correspond à une langue spécifiée pour cette valeur de paramètre. Les commentaires doivent être au format ISOLanguageCode:Comment (par exemple, -LocalizedFolderName FR-FR : « Ceci est un nom de dossier localisé en français de France »). |
MustDisplayCommentEnabled |
Facultatif |
System.Boolean |
Si le paramètre MustDisplayCommentEnabled est présent et défini sur $true, il définit un indicateur utilisé par Outlook 2007 pour empêcher les utilisateurs de réduire le commentaire sur un dossier (visible dans Outlook 2007 et dans Outlook Web Access). Si le paramètre est absent ou défini sur $false, les utilisateurs peuvent réduire le commentaire. |
StorageQuota |
Facultatif |
Microsoft.Exchange.Data.Unlimited |
Le paramètre StorageQuota spécifie la limite de taille de stockage du dossier de boîte aux lettres. Lorsque la taille du dossier dépasse cette limite, il est impossible d'ajouter des éléments. Vous pouvez spécifier les tailles de boîte aux lettres en Ko ou en Mo (par exemple 100 Ko ou 5 Mo). |
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. |
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-ManagedFolder permet de créer un dossier géré d'une capacité maximale de 1 Mo.
Dans le deuxième exemple, la commande New-ManagedFolder permet de créer un dossier géré ayant un nom par défaut et un commentaire en anglais, ainsi que des noms de dossier localisés en espagnol et en français, et des commentaires localisés en espagnol.
Dans le troisième exemple, une nouvelle instance du dossier par défaut Boîte de réception est créé.
New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"
New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"
New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox