Командлет New-DistributionGroup используется для создания новой группы рассылки.

Синтаксис

New-DistributionGroup -Name <String> -SamAccountName <String> -Type <Distribution | Security> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Name

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

System.String

Этот параметр определяет имя новой группы рассылки. Значение, заданное с помощью параметра Name, также используется в качестве значения DisplayName, если параметр DisplayName не задан.

Значение Name не может превышать в длину 64 символов.

Если используются различные значения Name и DisplayName:

  • Значение Name определяет имя группы рассылки в «Пользователи и компьютеры Active Directory», а также в поле Имя группы в консоли управления Exchange.

  • Значение DisplayName определяет имя группы рассылки в консоли управления Exchange и в глобальном списке адресов Exchange.

SamAccountName

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

System.String

Этот параметр определяет имя для клиентов объекта, работающих под управлением устаревших операционных систем. Параметр SamAccountName выводится в Active Directory и в консоли Exchange в поле Имя группы (до Windows 2000). Если не задан параметр Alias, истинны следующие условия:

  • Значение SAMAccountName используется для параметра Alias, при этом все пробелы превращаются в подчеркивания.

  • Значение SAMAccountName, все пробелы в котором преобразованы в подчеркивания, используется для создания основного адреса SMTP электронной почты объекта.

Type

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

Microsoft.Exchange.Management.RecipientTasks.GroupType

Этот параметр определяет тип группы, создаваемой в Active Directory. Область группы всегда является универсальной. Допустимыми являются значения Distribution и Security.

Alias

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

System.String

Этот параметр может быть использован для задания псевдонима группы рассылки. Затем параметр Alias используется для создания основного адреса SMTP электронной почты объекта. Значение Alias не может содержать пробелов. Если значение Alias не задано, для создания основного адреса SMTP электронной почты объекта используется значение SAMAccountName, в котором все пробелы преобразованы в подчеркивания.

Confirm

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

System.Management.Automation.SwitchParameter

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

DisplayName

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

System.String

Этот параметр может быть использован для задания имени группы рассылки в консоли управления Exchange и в глобальном списке адресов Exchange. Если параметр DisplayName не задан, для параметра DisplayName используется значение Name.

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

ManagedBy

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

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Этот параметр может быть использован, чтобы определить имя пользователя почтового ящика или контакта, которому разрешено использование электронной почты. Это имя появляется на вкладке Управляется объекта Active Directory. Для этого параметра можно использовать следующие значения:

  • Различающееся имя (DN)

  • Каноническое имя

  • GUID

  • Имя

  • Краткое имя

  • Устаревшее DN Exchange

  • Основной адрес SMTP электронной почты

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Этот параметр определяет, где в Active Directory создавать группу рассылки, используя канонический синтаксис имени.

TemplateInstance

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

System.Management.Automation.PSObject

Когда в качестве этого параметра используется существующий объект, командлет использует этот объект для создания копии объекта.

UseRusServer

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

System.String

Примечание.
Этот параметр доступен только в сервере Exchange Server 2007 с пакетом обновления 2 (SP2).

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Командлет New-DistributionGroup можно использовать для создания новых объектов групп Active Directory следующих типов:

  • Универсальная группа безопасности, имеющая доступ к почте

  • Универсальная группа рассылки

Группы рассылки используются для консолидации групп получателей в одну точку контакта для сообщений электронной почты. Группы рассылки нельзя использовать для назначения разрешений доступа к сетевым ресурсам в службе каталогов Active Directory.

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

  • роль администратора получателей Exchange;

  • роль оператора учета для соответствующих контейнеров Active Directory.

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере кода показано, как использовать командлет New-DistributionGroup для создания новой универсальной группы безопасности, которой разрешено использование электронной почты, со следующими параметрами:

  • Группа будет носить имя «Managers».

  • Эта группа будет создана в контейнере «Пользователи» домена Contoso.com.

  • Именем учетной записи SAM для группы будет «Managers».

  • Типом группы будет Security.

Копировать код
New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"