Командлет Set-MailboxDatabase используется для настройки атрибутов базы данных почтовых ящиков.
Синтаксис
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>]] |
Параметры
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Параметр Identity определяет базу данных почтовых ящиков, для которой нужно настроить один или несколько атрибутов. Можно использовать следующие значения:
Если имя сервера не задано, командлет выполнит поиск базы данных на локальном сервере. При наличии нескольких баз данных с одинаковым именем необходимо указать группу хранения. |
AllowFileRestore |
Необязательный |
System.Boolean |
Параметр AllowFileRestore определяет, разрешено ли восстанавливать базу данных из архива. У этого параметра два возможных значения: $true и $false. Если задано значение $true, команда разрешает подключение базы данных, не соответствующей записи базы данных в службе каталогов Active Directory. Если задано значение $false, команда не разрешает подключение базы данных, не соответствующей записи базы данных в службе каталогов Active Directory, поэтому заменить существующую базу данных на вновь созданную нельзя. |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется. |
DeletedItemRetention |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Параметр DeletedItemRetention указывает продолжительность хранения удаленных элементов. Чтобы указать значение, введите его как промежуток времени: дд.чч:мм:сс, где дд — дни, чч — часы, мм — минуты, а сс — секунды. Например, чтобы задать 15-часовой интервал, введите15:00:00. Максимальная продолжительность времени хранения удаленных элементов составляет 24 855 дней. По умолчанию удаленные элементы хранятся в течение 14 дней. Этот атрибут применяется ко всем почтовым ящикам в базе данных, у которых собственное значение атрибута хранения отсутствует. |
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы задать полное доменное имя контроллера домена, который записывает эти изменения конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. |
EventHistoryRetentionPeriod |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Параметр EventHistoryRetentionPeriod определяет продолжительность времени хранения данных событий. Эти данные события хранятся в таблице истории событий в хранилище Exchange. Они содержат сведения об изменениях различных объектов в базе данных почтовых ящиков. Можно использовать этот параметр, чтобы предотвратить чрезмерное увеличение таблицы истории событий, что приводит к увеличению занимаемого ею места на диске. Чтобы указать значение, введите его как промежуток времени: дд.чч:мм:сс, где дд — дни, чч — часы, мм — минуты, а сс — секунды. Например, чтобы указать 15-часовой интервал, введите 15:00:00. |
IndexEnabled |
Необязательный |
System.Boolean |
Параметр IndexEnabled определяет, следует ли включить поиск Exchange для этой базы данных почтовых ящиков. У этого параметра два возможных значения: $true и $false. |
Instance |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.MailboxDatabase |
Параметр Instance обычно используется в сценариях, когда администратору или разработчику нужно передать значения команде. Параметр Instance эквивалентен передаче результата одной команды на вход другой, но позволяет сценарию назначить значения через переменные вместо попытки создания конвейера. Параметр Instance редко используется администраторами, вводящими команды в командной строке. Он включен в таблицу параметров для сведения разработчиков. |
IssueWarningQuota |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр IssueWarningQuota задает размер почтового ящика, при котором пользователю отправляется предупреждающее сообщение. Этот атрибут применяется ко всем почтовым ящикам в этой базе данных почтовых ящиков, у которой собственное значение атрибута квоты предупреждения отсутствует. Можно указать целое число или значение «unlimited» (не ограничено). Значением по умолчанию является 1,9 ГБ. |
JournalRecipient |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
Параметр JournalRecipient задает почтовый ящик, в который отправляются отчеты журналов. |
MailboxRetention |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Параметр MailboxRetention задает продолжительность времени хранения удаленных почтовых ящиков. Чтобы указать значение, введите его как промежуток времени: дд.чч:мм:сс, где дд — дни, чч — часы, мм — минуты, а сс — секунды. Например, чтобы задать 15-часовой интервал, введите 15:00:00. Максимальная продолжительность времени хранения почтовых ящиков составляет 24 855 дней. По умолчанию удаленные почтовые ящики хранятся в течение 30 дней. Этот атрибут применяется ко всем почтовым ящикам в этой базе данных почтовых ящиков. |
MaintenanceSchedule |
Необязательный |
Microsoft.Exchange.Data.Schedule |
Параметр MaintenanceSchedule определяет график выполнения обслуживания базы данных почтовых ящиков. Обслуживание включает в себя оперативную дефрагментацию, удаление элементов, срок хранения которых истек, удаление неиспользуемых индексов и другие задачи по очистке. Используется следующий формат «первый_день.часы:минуты [AM/PM]-последний_день.часы:минуты [AM/PM]». Для первого и последнего дня можно использовать следующие значения:
Если следует использовать 24-часовой формат, исключите AM/PM. При использовании 12-часового формата между значением временем и обозначениями «AM» и «PM» должен быть пробел. Форматы могут быть смешанными. Промежуток от времени начала до времени окончания должен быть не менее 15 минут. Количество минут округляется вниз до значений 0, 15, 30 и 45. Если указано несколько интервалов, промежутки между ними должны составлять не менее 15 минут. Примеры:
|
MountAtStartup |
Необязательный |
System.Boolean |
Параметр MountAtStartup определяет, будет ли подключаться эта база почтовых ящиков при запуске службы Банка данных Microsoft Exchange. У этого параметра два возможных значения: $true и $false. |
Name |
Необязательный |
System.String |
Параметр Name задает имя базы данных почтовых ящиков. |
OfflineAddressBook |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter |
Параметр OfflineAddressBook определяет для этой базы данных почтовых ящиков связанную книгу адресов. |
ProhibitSendQuota |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ProhibitSendQuota определяет размер почтового ящика, при котором пользователи, связанные с почтовыми ящиками этой базы данных, больше не могут отправлять сообщения. Этот атрибут применяется ко всем почтовым ящикам в этой базе данных почтовых ящиков, у которой собственное значение атрибута квоты запрещения отправки отсутствует. Можно указать целое число или значение «unlimited» (не ограничено). |
ProhibitSendReceiveQuota |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ProhibitSendReceiveQuota указывает размер почтового ящика, при котором пользователь, связанный с этим почтовым ящиком, больше не может отправлять и получать сообщения. Этот атрибут применяется ко всем почтовым ящикам в этой базе данных почтовых ящиков, у которой собственное значение атрибута запрещения отправки и получения отсутствует. Можно указать целое число или значение «unlimited» (не ограничено). |
PublicFolderDatabase |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Параметр PublicFolderDatabase определяет для этой базы данных почтовых ящиков связанную базу данных общих папок. Можно использовать следующие значения:
|
QuotaNotificationSchedule |
Необязательный |
Microsoft.Exchange.Data.Schedule |
Параметр QuotaNotificationSchedule определяет график отправки сообщений квоты в почтовые ящики, размер которых достиг одного из значений квоты. Используется следующий формат «первый_день.часы:минуты [AM/PM]-последний_день.часы:минуты [AM/PM]». Для первого и последнего дня можно использовать следующие значения:
Если следует использовать 24-часовой формат, исключите AM/PM. Форматы могут быть смешанными. Промежуток от времени начала до времени окончания должен быть не менее 15 минут. Количество минут округляется вниз до значений 0, 15, 30 и 45. Если указано несколько интервалов, промежутки между ними должны составлять не менее 15 минут. Примеры:
|
RetainDeletedItemsUntilBackup |
Необязательный |
System.Boolean |
Параметр RetainDeletedItemsUntilBackup указывает, должны ли сохраняться удаленные элементы до следующего архивирования. У этого параметра два возможных значения: $true и $false. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется. |
Подробное описание
Для выполнения командлета Set-MailboxDatabase используемой учетной записи необходимо делегировать:
- роль администратора сервера Exchange и членство в локальной
группе администраторов на целевом сервере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
|
Пример
Следующий пример показывает, как задать продолжительность времени хранения удаленных элементов. Если для конкретного почтового ящика задано собственное время хранения элементов, то будет использоваться именно это значение, а не значение, определенное для базы данных почтовых ящиков.
Копировать код | |
---|---|
Set-MailboxDatabase "Mailbox Database01" -DeletedItemRetention 7.00:00:00 |