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.