Set-ManagedFolder
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2009-05-05
La cmdlet Set-ManagedFolder permet de modifier les paramètres de dossiers gérés.
Syntaxe
Set-ManagedFolder -Identity <ELCFolderIdParameter> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderName <String>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-StorageQuota <Unlimited>] [-WhatIf [<SwitchParameter>]]
Set-ManagedFolder [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderName <String>] [-Instance <ELCFolder>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-StorageQuota <Unlimited>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Set-ManagedFolder permet de modifier les paramètres spécifiés d'un dossier géré.
La cmdlet Set-ManagedFolder accepte un dossier géré personnalisé ou une chaîne d'identité comme entrée en pipeline.
Pour exécuter la cmdlet Set-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.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter |
Le paramètre Identity spécifie le nom, le nom unique ou le GUID 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 Office Outlook 2007. |
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 du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. |
FolderName |
Facultatif |
System.String |
Le paramètre FolderName spécifie le nom de l'objet dossier tel qu'il s'affiche dans les boîtes aux lettres des utilisateurs. |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ELCFolder |
Le paramètre Instance permet de transmettre un objet à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à 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'un client affichant des commentaires correspond à une langue spécifiée pour cette valeur de paramètre. Les commentaires doivent être de la forme codeLangueISO:Commentaire. Par exemple, -LocalizedComment FR-FR:« Commentaire localisé en français. » |
LocalizedFolderName |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Le paramètre LocalizedFolderName spécifie les noms de dossier localisés et leurs langues. Les 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 de la forme codeLangueISO:Commentaire. Par exemple, -LocalizedFolderName FR-FR:« Nom de dossier localisé en français. » |
MustDisplayCommentEnabled |
Facultatif |
System.Boolean |
Si le paramètre MustDisplayCommentEnabled est présent et défini sur $true, il définit un indicateur utilisé par tout client affichant des commentaires et acceptant ce paramètre. Cela permet d’éviter que les utilisateurs ne réduisent le commentaire sur un dossier (visible uniquement dans Outlook 2007). Si le paramètre est absent ou défini sur $false, les utilisateurs peuvent réduire le commentaire. |
Name |
Facultatif |
System.String |
Le paramètre Name spécifie un nom unique pour les paramètres de contenu. Le paramètre Name n'apparaît pas dans les boîtes aux lettres des utilisateurs. |
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). Le paramètre StorageQuota est valide pour les dossiers gérés personnalisés dans Outlook 2007. |
BaseFolderOnly |
Facultatif |
System.Boolean |
Le paramètre BaseFolderOnly permet de contrôler la période de rétention des messages pour les sous-dossiers individuels à l'aide des paramètres de contenu géré. La définition de cet indicateur sur True pour un dossier racine empêche l'Assistant Dossier géré d'appliquer une stratégie de boîte aux lettres au contenu des sous-dossiers du dossier racine. |
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 Set-ManagedFolder permet de définir le quota de stockage pour le dossier géré nommé MyManagedFolder sur 100 Ko.
Le deuxième exemple, qui compte trois lignes, présente l'utilisation du paramètre Instance consistant à transmettre une instance d'un dossier géré, nommé My Managed Folder, à la commande Set-ManagedFolder pour définir un nouveau commentaire.
Set-ManagedFolder MyManagedFolder -StorageQuota 100KB
$a = Get-ManagedFolder "My Managed Folder"
$a.Comment = "This is a comment."
Set-ManagedFolder -Instance $a