Set-MailboxDatabase

 

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

Dernière rubrique modifiée : 2007-09-19

La cmdlet Set-MailboxDatabase permet de définir les attributs d'une base de données de boîtes aux lettres.

Syntaxe

Set-MailboxDatabase -Identity <DatabaseIdParameter> [-AllowFileRestore <$true | $false>] [-Confirm [<SwitchParameter>]] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IndexEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-JournalRecipient <RecipientIdParameter>] [-MailboxRetention <EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true | $false>] [-Name <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-PublicFolderDatabase <DatabaseIdParameter>] [-QuotaNotificationSchedule <Schedule>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-MailboxDatabase [-AllowFileRestore <$true | $false>] [-Confirm [<SwitchParameter>]] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IndexEnabled <$true | $false>] [-Instance <MailboxDatabase>] [-IssueWarningQuota <Unlimited>] [-JournalRecipient <RecipientIdParameter>] [-MailboxRetention <EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true | $false>] [-Name <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-PublicFolderDatabase <DatabaseIdParameter>] [-QuotaNotificationSchedule <Schedule>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Set-MailboxDatabase, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre Identity identifie la base de données de boîtes aux lettres pour laquelle vous voulez définir un ou plusieurs attributs. Vous pouvez utiliser les valeurs suivantes :

  • GUID

  • Nom unique

  • Nom de la base de données de boîtes aux lettres

  • Nom de serveur\nom de groupe de stockage\nom de base de données

  • Nom de serveur\nom de base de données

  • Nom de groupe de stockage\nom de base de données

Si vous ne spécifiez pas le nom de serveur, la cmdlet recherche la base de données sur le serveur local. Si vous avez plusieurs bases de données avec le même nom, vous devez spécifier le groupe de stockage.

AllowFileRestore

Facultatif

System.Boolean

Le paramètre AllowFileRestore spécifie si la restauration d’une base de données à partir d’une sauvegarde est autorisée. Les valeurs possibles sont $true et $false. Si vous spécifiez $true, la commande autorise le montage d’une base de données ne correspondant pas à l’entrée de base de données dans le service d'annuaire Active Directory. Si vous spécifiez $false, la commande n’autorise pas le montage d’une base de données ne correspondant pas à l’entrée de base de données dans Active Directory, de sorte qu’il n'est pas possible de remplacer une base de données existante par une base de données nouvellement créé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.

DeletedItemRetention

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Le paramètre DeletedItemRetention spécifie la période pendant laquelle les éléments supprimés sont conservés. Pour spécifier une valeur, entrez-la sous forme de période : jj.hh:mm:ss où j = jours, h = heures, m = minutes et s = secondes. Par exemple, pour spécifier un intervalle de 15 heures, entrez 15:00:00. La durée maximale de rétention des éléments supprimés est 24 855 jours. Par défaut, les éléments supprimés sont conservés pendant 14 jours. Cet attribut s’applique à toutes les boîtes aux lettres de la base de données de boîtes aux lettres qui n’ont pas leur propre attribut de rétention défini.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande.

EventHistoryRetentionPeriod

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Le paramètre EventHistoryRetentionPeriod spécifie la période pendant laquelle les données d'événement sont conservées. Ces données d'événement sont stockées dans la table Historique des événements de la banque d'informations Exchange. Ces données incluent des informations sur les modifications apportées à divers objets de la base de données de boîtes aux lettres. Ce paramètre permet d'empêcher que la table Historique des événements ne devienne trop volumineuse et utilise un espace disque trop important. Pour spécifier une valeur, entrez-la sous forme de période : jj.hh:mm:ss où j = jours, h = heures, m = minutes et s = secondes. Par exemple, pour spécifier un intervalle de 15 heures, entrez 15:00:00.

IndexEnabled

Facultatif

System.Boolean

Le paramètre IndexEnabled spécifie si le service de recherche Exchange est autorisé pour cette base de données de boîtes aux lettres. Les valeurs possibles pour ce paramètre sont $true ou $false.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.MailboxDatabase

Le paramètre Instance est généralement utilisé dans les scripts dans lesquels un administrateur ou un développeur doit spécifier des valeurs pour une commande. Le paramètre Instance revient à canaliser le résultat d’une commande à une autre, mais permet au script d’affecter des valeurs à l'aide de variables plutôt que de tenter de construire un pipeline. Le paramètre Instance est rarement utilisé par les administrateurs qui tapent les commandes à partir d'une invite de commandes. Il est inclus dans la table des paramètres à laquelle les développeurs peuvent se référer.

IssueWarningQuota

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre IssueWarningQuota spécifie la taille de boîte aux lettres à partir de laquelle un message d'avertissement est envoyé à l'utilisateur.

Cet attribut s’applique à toutes les boîtes aux lettres de la base de données de boîtes aux lettres n’ayant pas leur propre attribut de quota d’avertissement défini. Vous devez spécifier un nombre entier ou « unlimited ». La valeur par défaut est 1,9 gigaoctets (Go).

JournalRecipient

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Le paramètre JournalRecipient spécifie la boîte aux lettres à laquelle les états de journal sont envoyés.

MailboxRetention

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Le paramètre MailboxRetention spécifie la période pendant laquelle les boîtes aux lettres supprimées sont conservées. Pour spécifier une valeur, entrez-la sous forme de période : jj.hh:mm:ss où j = jours, h = heures, m = minutes et s = secondes. Par exemple, pour spécifier un intervalle de 15 heures, entrez 15:00:00. La durée maximale de rétention des boîtes aux lettres est 24 855 jours. Par défaut, les boîtes aux lettres supprimées sont conservées pendant 30 jours. Cet attribut s’applique à toutes les boîtes aux lettres de la base de données de boîtes aux lettres.

MaintenanceSchedule

Facultatif

Microsoft.Exchange.Data.Schedule

Le paramètre MaintenanceSchedule spécifie la date d’exécution de la maintenance sur la base de données de boîtes aux lettres. La maintenance inclut la défragmentation en ligne, la suppression des éléments dont la période de rétention est dépassée, la suppression des index inutilisés et d'autres tâches de nettoyage.

Le format est Jour_de_début.Heure:Minute [AM/PM]-Jour_de_fin.Heure:Minute [AM/PM]. Les valeurs suivantes peuvent être utilisées pour les jours de début et de fin :

  • Nom complet du jour

  • Nom abrégé du jour

  • Nombre entier compris entre 0 et 6, où 0 = Dimanche

Si vous préférez utiliser une horloge basée sur 24 heures, omettez les indications AM/PM. Si vous utilisez les indications AM/PM, vous devez insérer une espace entre l'heure et ces indications.

Vous pouvez mélanger les formats.

Les heures de début et de fin doivent être séparées d'au moins 15 minutes. Les minutes sont arrondies à la valeur inférieure à 0, 15, 30 ou 45. Si vous spécifiez plusieurs intervalles, ils doivent être séparés d'au moins 15 minutes les uns des autres.

Exemples :

  • "Dim.23:30-Lun.1:30"

  • 6.22:00-6.22:15 (la maintenance s'exécutera du samedi à 22:00 au samedi à 22:15).

  • "Lundi.4:30 AM-Lundi.5:30 AM","Mercredi.4:30 AM-Mercredi.5:30 AM" (la maintenance s'exécutera les lundi et mercredi matins de 4:30 à 5:30).

  • "Dim.1:15-Lundi.23:00"

MountAtStartup

Facultatif

System.Boolean

Le paramètre MountAtStartup spécifie si la base de données de boîtes aux lettres doit être montée au démarrage du service de banque d’informations de Microsoft Exchange. Les valeurs possibles pour ce paramètre sont $true ou $false.

Name

Facultatif

System.String

Le paramètre Name spécifie le nom de la base de données de boîtes aux lettres.

OfflineAddressBook

Facultatif

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

Le paramètre OfflineAddressBook spécifie le carnet d'adresses associé à cette base de données de boîtes aux lettres.

ProhibitSendQuota

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ProhibitSendQuota spécifie la taille de boîte aux lettres à partir de laquelle les utilisateurs associés à des boîtes aux lettres dans cette base de données ne peuvent plus envoyer de messages. Cet attribut s’applique à toutes les boîtes aux lettres de la base de données de boîtes aux lettres qui n’ont pas leurs propres attributs de quota d’interdiction d’envoi définis.

Vous devez spécifier un nombre entier ou « unlimited ».

ProhibitSendReceiveQuota

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ProhibitSendReceiveQuota spécifie la taille de boîte aux lettres à partir de laquelle l'utilisateur associé à la boîte aux lettres ne peut plus envoyer ou recevoir de messages. Cet attribut s’applique à toutes les boîtes aux lettres de la base de données de boîtes aux lettres qui n’ont pas leurs propres attributs de quota d’interdiction d’envoi et de réception définis.

Vous devez spécifier un nombre entier ou « unlimited ».

PublicFolderDatabase

Facultatif

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre PublicFolderDatabase spécifie la base de données de dossiers publics associée pour cette base de données de boîtes aux lettres. Vous pouvez utiliser les valeurs suivantes :

  • GUID

  • Nom unique

  • Nom de la base de données de dossiers publics

  • Nom de serveur\nom de groupe de stockage\nom de base de données

  • Nom de serveur\nom de base de données

  • Nom de groupe de stockage\nom de base de données

QuotaNotificationSchedule

Facultatif

Microsoft.Exchange.Data.Schedule

Le paramètre QuotaNotificationSchedule spécifie quand des messages de quota sont envoyés aux boîtes aux lettres qui ont atteint une des valeurs de quota.

Le format est Jour_de_début.Heure:Minute [AM/PM]-Jour_de_fin.Heure:Minute [AM/PM]. Les valeurs suivantes peuvent être utilisées pour les jours de début et de fin :

  • Nom complet du jour

  • Nom abrégé du jour

  • Nombre entier compris entre 0 et 6, où 0 = Dimanche

Si vous préférez utiliser une horloge basée sur 24 heures, omettez les indications AM/PM.

Vous pouvez mélanger les formats.

Les heures de début et de fin doivent être séparées d'au moins 15 minutes. Les minutes sont arrondies à la valeur inférieure à 0, 15, 30 ou 45. Si vous spécifiez plusieurs intervalles, ils doivent être séparés d'au moins 15 minutes les uns des autres.

Exemples :

  • "Dim.23:30-Lun.1:30"

  • 6.22:00-6.22:15 (la notification s'étendra du samedi à 22:00 au samedi à 22:15).

  • "Lundi.4:30 AM-Lundi.5:30 AM","Mercredi.4:30 AM-Mercredi.5:30 AM" (la maintenance s'exécutera les lundi et mercredi matins de 4:30 à 5:30).

  • "Dim.1:15-Lundi.23:00"

RetainDeletedItemsUntilBackup

Facultatif

System.Boolean

Le paramètre RetainDeletedItemsUntilBackup indique si les éléments supprimés sont conservés jusqu'à la prochaine sauvegarde. Les valeurs possibles pour ce paramètre sont $true ou $false.

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

Les exemples suivants montrent comment définir la durée de rétention des éléments supprimés. Si la rétention d’éléments est définie pour une boîte aux lettres spécifique, cette valeur sera utilisée au lieu de la valeur définie dans la base de données de boîtes aux lettres.

Set-MailboxDatabase "Mailbox Database01" -DeletedItemRetention 7.00:00:00