Set-PublicFolder

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2012-03-26

Командлет Set-PublicFolder используется для установки атрибутов общих папок.

Синтаксис

Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-LocalReplicaAgeLimit <EnhancedTimeSpan>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-PublicFolder [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <PublicFolder>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Подробное описание

Для выполнения командлета Set-PublicFolder используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора общих папок Exchange и членство в локальной группе администраторов на целевом сервере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательный Тип Описание

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

С помощью параметра Identity можно задать GUID или имя общей папки, которые представляют определенную общую папку. Можно также включить путь в формате «общая_папка_верхнего_уровня\общая_папка».

Можно опустить метку параметра Identity, оставив только имя общей папки или GUID.

AgeLimit

Необязательный

Microsoft.Exchange.Data.EnhancedTimeSpan

Параметр времени хранения AgeLimit задает общее время хранения данных в папке. Реплики этой общей папки будут автоматически удаляться при превышении времени хранения. Этот параметр и параметр использования времени хранения базы данных UseDatabaseAgeDefaults являются взаимоисключающими.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает контроллер домена, который будет использоваться для записи этого изменения конфигурации в Active Directory. Укажите полное доменное имя нужного контроллера домена.

HiddenFromAddressListsEnabled

Необязательный

System.Boolean

С помощью параметра видимости в списках адресов HiddenFromAddressListsEnabled можно указать, будет ли общая папка видна в списках адресов.

Instance

Необязательный

Microsoft.Exchange.Data.Mapi.PublicFolder

Параметр Instance позволяет передать в команду весь объект для обработки. Он обычно используется в сценариях, где команде необходимо передавать целый объект.

IssueWarningQuota

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр IssueWarningQuota указывает размер общих папок, при достижении которого владельцу выдается сообщение о том, что папка почти заполнена.

LocalReplicaAgeLimit

Необязательный

Microsoft.Exchange.Data.EnhancedTimeSpan

Параметр LocalReplicaAgeLimit указывает срок хранения реплики на подключенном сервере (если на нем имеется реплика). Чтобы удалить ограничение на срок хранения, присвойте параметру значение «$null».

MaxItemSize

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр MaxItemSize указывает максимальный размер элемента, который можно опубликовать, в килобайтах (КБ). Этот параметр и параметр использования квоты по умолчанию UseDatabaseQuotaDefaults являются взаимоисключающими.

Name

Необязательный

System.String

Параметр Name указывает имя общей папки.

PerUserReadStateEnabled

Необязательный

System.Boolean

Параметр PerUserReadStateEnabled контролирует хранение прочитанных и непрочитанных данных для отдельных пользователей.

ProhibitPostQuota

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр ProhibitPostQuota указывает размер общей папки, при достижении которого пользователям выдается сообщение о том, что папка заполнена. Пользователи не смогут ничего поместить в папку, размер которой превышает значение параметра ProhibitPostQuota.

Replicas

Необязательный

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter[]

Параметр Replicas указывает список серверов почтовых ящиков, с которыми нужно выполнять репликацию общей папки.

ReplicationSchedule

Необязательный

Microsoft.Exchange.Data.Schedule

Параметр ReplicationSchedule указывает расписание репликации для папки в следующем формате:

День_недели.Час:Минута[AM/PM]-День_недели.Час:Минута[AM/PM].

Дни недели можно указывать в полной или в сокращенной форме. При желании можно использовать 24-часовой формат, исключив параметр AM/PM. Форматы могут быть смешанными.

Пример: Вс. 1:15 AM-Пн. 23:00

Этот параметр и параметр UseDatabaseReplicationSchedule являются взаимоисключающими.

RetainDeletedItemsFor

Необязательный

Microsoft.Exchange.Data.EnhancedTimeSpan

Параметр RetainDeletedItemsFor указывает время хранения удаленных элементов. Этот параметр и параметр UseDatabaseRetentionDefaults являются взаимоисключающими.

Server

Необязательный

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server указывает сервер, на котором будут выполняться выбранные операции.

UseDatabaseAgeDefaults

Необязательный

System.Boolean

Параметр UseDatabaseAgeDefaults определяет использование времени хранения базы данных.

UseDatabaseQuotaDefaults

Необязательный

System.Boolean

Параметр UseDatabaseQuotaDefaults указывает, использовать ли ограничения квоты общей папки.

UseDatabaseReplicationSchedule

Необязательный

System.Boolean

Параметр UseDatabaseReplicationSchedule указывает расписание репликации общей папки.

UseDatabaseRetentionDefaults

Необязательный

System.Boolean

Параметр UseDatabaseRetentionDefaults указывает, использовать ли период хранения по умолчанию базы данных.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

  

Исключения

Исключения Описание

  

Пример

В первом примере команда Set-PublicFolder используется для отмены использования общей папкой расписания репликации базы данных по умолчанию.

Во втором примере команда Set-PublicFolder используется для установки расписания репликации в значение «Всегда».

В третьем примере команда Set-PublicFolder используется для установки репликации только по выходным.

Set-PublicFolder "\Customer Service Requests" -UseDatabaseReplicationSchedule $false
Set-PublicFolder "\Customer Service Requests" -ReplicationSchedule Always
Set-PublicFolder \MyPublicFolder -ReplicationSchedule "Saturday.12:00 AM-Monday.12:00 AM"

Все параметры команды Set-PublicFolder допускают конвейерные входные данные в качестве аргументов и стойкого типа.

Когда параметр UseDatabaseQuotaDefaults установлен в значение «истина», следующим значениям назначаются значения по умолчанию:

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

Командлет Set-PublicFolder нельзя использовать для изменения любого из указанных ниже значений, когда параметру UseDatabaseQuotaDefaults присвоено значение «истина»:

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

Это обусловлено тем, что данные значения неприменимы при использовании квот базы данных по умолчанию.

В Exchange Server 2007 c пакетом обновления 2 (SP2) значение IssueWarningQuota должно быть меньше или равно значению ProhibitPostQuota. Кроме того, значение MaxItemSize должно быть меньше или равно значению ProhibitPostQuota.