New-ManagedFolder
Этот командлет доступен только в Exchange Server 2010 г.
Используйте командлет New-ManagedFolder для создания объекта управляемой папки для управления записями обмена сообщениями (MRM).
Эта команда не принимает входные данные конвейера.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-ManagedFolder
[-Name] <String>
-DefaultFolderType <DefaultManagedFolderType>
[-BaseFolderOnly <Boolean>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-LocalizedComment <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
New-ManagedFolder
[-Name] <String>
-FolderName <String>
[-LocalizedFolderName <MultiValuedProperty>]
[-StorageQuota <Unlimited>]
[-BaseFolderOnly <Boolean>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-LocalizedComment <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
Описание
Командлет New-ManagedFolder создает управляемую папку в Active Directory. После создания нового объекта управляемой папки необходимо выполнить следующие действия, чтобы использовать его для MRM:
- Создайте параметры управляемого содержимого для папки. Дополнительные сведения см. в разделе Создание параметров управляемого содержимого.
- Свяжите управляемую папку с существующей политикой почтовых ящиков управляемых папок или создайте политику почтовых ящиков управляемых папок и свяжите с ней управляемую папку.
- Применение политики почтовых ящиков управляемых папок к почтовому ящику пользователя. Дополнительные сведения см. в разделеПрименить политику почтовых ящиков управляемых папок для пользователей.
- Убедитесь, что помощник по управляемым папкам запланирован или запустите помощник по управляемым папкам вручную. Сведения о планировании помощника по управляемым папкам см. в разделе Настройка помощника по управляемым папкам. При запуске помощника по управляемым папкам он настраивает папки по умолчанию как управляемые и создает все управляемые пользовательские папки в почтовом ящике пользователя с указанными параметрами.
- Дополнительные сведения о шагах по реализации MRM в Microsoft Exchange Server 2010 г. см. в статье Развертывание управления записями сообщений.
По умолчанию с помощью этого командлета создаются управляемые пользовательские папки. Однако можно также создать дополнительные копии управляемых папок по умолчанию с помощью параметра DefaultFolderType, чтобы указать тип папки по умолчанию для создания (например, дополнительную папку "Входящие"). При создании нескольких копий управляемой папки по умолчанию для каждой из них можно назначить разные параметры содержимого. Например, у вас могут быть две папки "Входящие", одна с именем InboxSixMonths, а другая — InboxOneYear. Затем можно назначить период хранения в шесть месяцев для первой папки и один год для второй папки с помощью командлета New-ManagedContentSettings (или с помощью мастера создания параметров управляемого содержимого в консоли управления Exchange). Необходимо назначить уникальное имя (с помощью параметра Name) каждой из создаваемых управляемых папок по умолчанию. Однако пользователи всегда видят неизменное имя папки по умолчанию. В примере, независимо от того, назначена ли пользователям папка InboxSixMonths или папка InboxOneYear, папка "Входящие", которую они видят в своем почтовом ящике, помечена как "Входящие". Хотя имена папок, которые пользователи видят в своих почтовых ящиках, можно переназначить для управляемых пользовательских папок (с помощью параметра folderName команды Set-ManagedFolder), имена папок, отображаемые пользователями для управляемых папок по умолчанию, изменить нельзя.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"
В этом примере создается управляемая папка с максимальной емкостью 1 МБ.
Пример 2
New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"
В этом примере создается управляемая папка с именем папки по умолчанию и комментарием на английском языке, локализованным именем папки на испанском и французском языках и локализованным комментарием на испанском и французском языках.
Пример 3
New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox
В этом примере создается экземпляр папки "Входящие" по умолчанию.
Параметры
-BaseFolderOnly
Параметр BaseFolderOnly указывает, необходимо ли применять параметры управляемого содержимого только к управляемой папке или к данной папке и ко всем ее вложенным папкам.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Comment
Параметр Comment указывает комментарий администратора по умолчанию для отображения с папкой в Майкрософт Office Outlook 2007 и Майкрософт Office Outlook Web App. Комментарий может содержать до 255 символов, включая пробелы.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false
. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-DefaultFolderType
Параметр DefaultFolderType указывает тип создаваемой папки по умолчанию, например папку "Входящие" или "Удаленные".
Политика почтовых ящиков управляемых папок может содержать только одну управляемую папку для каждого типа папок по умолчанию. Дополнительные папки по умолчанию определенного типа, например Входящие, можно создавать и добавлять в различные политики почтовых ящиков. Это позволяет назначать различные параметры управляемого содержимого для определенного типа папок по умолчанию для разных наборов пользователей.
Например, у вас могут быть две папки по умолчанию типа Входящие: одна с параметрами управляемого содержимого, заданными для хранения сообщений в течение одного месяца, а другая с параметрами хранения сообщений в течение одного года. Каждая управляемая папка по умолчанию должна иметь уникальное имя (присваивается с помощью параметра Name).
Если значение не введено для параметра DefaultFolderType, оно обрабатывается как управляемая пользовательская папка.
По умолчанию можно указать следующие типы папок:
- Календарь
- Контакты
- DeletedItems
- Черновики
- Inbox;
- Нежелательная почта
- Журнал
- Примечания.
- Исходящие
- SentItems
- Задачи
- Все
- ManagedCustomFolder
- RssSubscriptions
- SyncIssues
- ConversationHistory
Type: | DefaultManagedFolderType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-DomainController
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-FolderName
Параметр FolderName указывает имя папки в том виде, в котором оно отображается в почтовых ящиках пользователей. Имя папки может содержать до 255 символов. Невозможно задать параметр FolderName для управляемых папок по умолчанию, например для папки "Входящие".
Параметр FolderName не следует путать с параметром Name.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-LocalizedComment
С помощью параметра LocalizedComment можно указать локализованные комментарии администратора и их языки. Если параметр языка Outlook 2007 соответствует одному из языковых стандартов, указанных в этом параметре, отображается соответствующий локализованный комментарий. Комментарии должны быть в формате ISOLanguageCode:Comment (например, -LocalizedComment EN-US:"Это локализованное примечание на английском языке США").
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-LocalizedFolderName
Параметр LocalizedFolderName указывает локализованные имена папок и их языки. Если параметр языка Outlook 2007 соответствует одному из языковых стандартов, указанных в этом параметре, отображается соответствующее локализованное имя папки. Имена папок должны быть в формате ISOLanguageCode:FolderName (например, -LocalizedFolderName EN-US:"критически важный для бизнеса").
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MustDisplayCommentEnabled
Параметр MustDisplayCommentEnabled указывает, следует ли задать флаг, используемый Outlook 2007, чтобы предотвратить минимизацию комментариев к папке (видимых в Outlook 2007 и Outlook Web App). Если параметр MustDisplayCommentEnabled присутствует и имеет значение $true, параметр задает флаг, используемый в Outlook 2007, чтобы запретить пользователям минимизировать комментарии к папке. Если этот параметр отсутствует или если ему присвоено значение $false, пользователи могут свернуть комментарий.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Name
Параметр Name задает уникальное имя объекта управляемой папки в Active Directory. Имя может содержать до 65 символов. В то время как параметр FolderName указывает имя папки, отображаемое для пользователей в клиентах, параметр Name используется средствами администрирования Exchange для представления объекта управляемой папки.
Параметр Name не следует путать с параметром FolderName.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-StorageQuota
С помощью параметра StorageQuota можно указать ограничение размера хранилища папки почтового ящика. Если размер папки превышает это ограничение, в папку невозможно будет добавить дополнительные элементы. Ограничения на размер хранилища можно указать в килобайтах (КБ) или мегабайтах (МБ), например 100 КБ или 5 МБ.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.