Set-ManagedFolder

 

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

Последнее изменение раздела: 2009-05-05

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

Синтаксис

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>]]

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

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

Командлет Set-ManagedFolder принимает в качестве входных данных управляемую папку или строку идентификации.

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

  • роль администратора организации Exchange.

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

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Параметр Identity определяет имя, различающееся имя или идентификатор GUID управляемой папки.

Comment

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

System.String

С помощью параметра Comment можно указать комментарий администратора по умолчанию, который будет отображаться вместе с папкой в Microsoft Office Outlook 2007.

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, получающего данные из службы каталогов Active Directory, включите в команду параметр DomainController.

FolderName

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

System.String

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

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ELCFolder

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

LocalizedComment

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

Microsoft.Exchange.Data.MultiValuedProperty

С помощью параметра LocalizedComment можно указать локализованные комментарии администратора и их языки. Локализованные комментарии отображаются вместо комментариев по умолчанию, если языковые параметры клиента, у которого отображаются комментарии, совпадают с языком, указанным в значении этого параметра. Комментарии должны указываться в форме ISOLanguageCode:Comment. Например, -LocalizedComment EN-US:"Это локализованный комментарий на русском языке".

LocalizedFolderName

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

Microsoft.Exchange.Data.MultiValuedProperty

С помощью параметра LocalizedFolderName можно указать локализованные имена папок и их языки. Локализованные имена папок отображаются вместо имен папок по умолчанию, если языковые параметры Outlook 2007 совпадают с языком, указанным в значении этого параметра. Комментарии должны указываться в форме ISOLanguageCode:Comment. Например, -LocalizedFolderName RU-RU:"Это локализованное имя папки на русском языке".

MustDisplayCommentEnabled

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

System.Boolean

Если для параметра MustDisplayCommentEnabled указано значение «$true», этот параметр устанавливает флаг, используемый клиентом, который отображает комментарии и принимает данный параметр. Это не позволяет пользователям свернуть комментарий к папке, который отображается только в Outlook 2007. Если параметр отсутствует или имеет значение «$false», пользователи могут свернуть комментарий.

Name

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

System.String

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

StorageQuota

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

Microsoft.Exchange.Data.Unlimited

С помощью параметра StorageQuota можно указать ограничение размера хранилища папки почтового ящика. Если размер папки превышает это ограничение, в папку невозможно будет добавить дополнительные элементы. Размеры почтовых ящиков могут быть указаны в килобайтах или мегабайтах, например, 100 КБ или 5 МБ. Параметр StorageQuota допустим для управляемых настраиваемых папок в Outlook 2007.

BaseFolderOnly

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

System.Boolean

Параметр BaseFolderOnly позволяет контролировать период хранения сообщений для отдельных подпапок с использованием параметров управляемого содержимого. Установка этого флага в значение «Истина» для корневой папки не позволяет помощнику для управляемых папок применять политику почтового ящика к содержимому подпапок корневой папки.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

  

Исключения

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

  

Пример

В первом примере команда Set-ManagedFolder используется для установки квоты хранилища равной 100 КБ для управляемой папки с названием MyManagedFolder.

Во втором примере (три нижние линии) показано использование параметра Instance посредством передачи экземпляра управляемой папки с названием My Managed Folder в команду Set-ManagedFolder для указания нового комментария.

Set-ManagedFolder MyManagedFolder -StorageQuota 100KB

$a = Get-ManagedFolder "My Managed Folder"
$a.Comment = "This is a comment."
Set-ManagedFolder -Instance $a