Поделиться через


Командлет New-DistributionGroup (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

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

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

Синтаксис

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

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

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

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

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

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

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

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

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

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

Параметры

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

Имя

Обязательность

System.String

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

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

Если значения параметров Name и DisplayName различны:

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

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

OrganizationalUnit

Обязательность

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

SamAccountName

Обязательность

System.String

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

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

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

Тип

Обязательность

Microsoft.Exchange.Management.RecipientTasks.GroupType

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

псевдоним.

Дополнительно

System.String

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

DisplayName

Дополнительно

System.String

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

С помощью параметра DomainController можно указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory.

ManagedBy

Дополнительно

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

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

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

  • GUID;

  • Имя

  • краткое имя

  • Различающееся имя в прежнем формате Exchange

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

TemplateInstance

Дополнительно

System.Management.Automation.PSObject

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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

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

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

New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"