Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

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

Синтаксис

New-DistributionGroup -Name <String> [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-BypassNestedModerationEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-CopyOwnerToMember <SwitchParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ExternalDirectoryObjectId <String>] [-IgnoreNamingPolicy <SwitchParameter>] [-ManagedBy <MultiValuedProperty>] [-MemberDepartRestriction <Closed | Open | ApprovalRequired>] [-MemberJoinRestriction <Closed | Open | ApprovalRequired>] [-Members <MultiValuedProperty>] [-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-Notes <String>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-PartnerObjectId <Guid>] [-PrimarySmtpAddress <SmtpAddress>] [-RoomList <SwitchParameter>] [-SamAccountName <String>] [-SendModerationNotifications <Never | Internal | Always>] [-Type <Distribution | Security>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Name

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

System.String

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

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

Примечание.
При принудительном применении политики именования групп необходимо следовать условиям именования, заданным параметрами DistributionGroupNameBlockedWordList и DistributionGroupNamingPolicy командлета Set-OrganizationConfig.

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

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

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

Alias

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

System.String

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

ArbitrationMailbox

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Параметр ArbitrationMailbox задает почтовый ящик, который используется для управления модерированием.

BypassNestedModerationEnabled

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

System.Boolean

Параметр BypassNestedModerationEnabled указывает, разрешено ли родительской группе модераторов утверждать сообщения для любых вложенных групп, которые также являются модерируемыми. Если данный параметр установлен как $true, то после одобрения модератором отправленного в эту группу рассылки сообщения, оно автоматически становится одобренным для любых других модерируемых получателей, которые являются членами данной группы рассылки. Значение по умолчанию: $false.

Примечание.
Данный параметр может быть установлен только вышестоящей организацией или администраторами-владельцами.

Confirm

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

System.Management.Automation.SwitchParameter

CopyOwnerToMember

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

System.Management.Automation.SwitchParameter

Параметр CopyOwnerToMember определяет, что получатель, указанный в параметре ManagedBy , является также членом группы рассылки.

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

ExternalDirectoryObjectId

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

System.String

IgnoreNamingPolicy

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

System.Management.Automation.SwitchParameter

Параметр IgnoreNamingPolicy указывает, что политика именования, заданная в параметре DistributionGroupNamingPolicy командлета Set-OrganizationConfig, может быть пропущена. Указывать значение для этого параметра необязательно.

ManagedBy

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

Microsoft.Exchange.Data.MultiValuedProperty

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

  • Идентификатор GUID

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

  • Имя участника-пользователя (UPN)

  • Старое различающееся имя Exchange

  • Домен\Имя_учетной_записи

  • SMTP-адрес

Чтобы указать пользователя Служба каталогов Active Directory, используйте одно из следующих значений:

  • GUID

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

  • UPN

  • Домен\Имя_учетной_записи

Получатели, указанные в параметре ManagedBy, не являются членами группы рассылки. Если необходимо добавить получателей, указанных в этом параметре, как членов группы рассылки, то нужно использовать параметр CopyOwnerToMember.

MemberDepartRestriction

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

Microsoft.Exchange.Data.Directory.Recipient.MemberUpdateType

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

  • Open

  • Closed

  • ApprovalRequired

Примечание.
Универсальные группы безопасности не могут использовать значение Open. По умолчанию для них установлено значение Closed.

MemberJoinRestriction

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

Microsoft.Exchange.Data.Directory.Recipient.MemberUpdateType

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

  • Open

  • Closed

  • ApprovalRequired

Примечание.
Универсальные группы безопасности не могут использовать значение Open. По умолчанию для них установлено значение Closed.

Members

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

Microsoft.Exchange.Data.MultiValuedProperty

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

  • GUID

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

  • UPN

  • Имя LegacyExchangeDN

  • Домен\Имя_учетной_записи

  • SMTP-адрес

Чтобы указать пользователя Служба каталогов Active Directory, используйте одно из следующих значений:

  • GUID

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

  • UPN

  • Домен\Имя_учетной_записи

ModeratedBy

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ModeratedBy указывает пользователей, ответственных за контроль сообщений, отправленных в эту группу. Чтобы указать несколько пользователей, используйте запятые.

Параметр ModeratedBy требуется, если для параметра ModerationEnabled установлено значение $true. Если оставить данный параметр незаданным и существует пользователь, который уже указан в качестве администратора для данной группы рассылки, параметр ModeratedBy автоматически заменяется параметром ManagedBy этой группы рассылки. В противном случае возвращается ошибка.

ModerationEnabled

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

System.Boolean

Параметр ModerationEnabled указывает, включен ли контроль группы рассылки. Чтобы включить контроль, установите для этого параметра значение $true. Чтобы отключить контроль, установите для этого параметра значение $false.

Значение по умолчанию: $false.

Notes

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

System.String

Параметр Notes указывает дополнительные сведения о группе рассылки.

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit указывает контейнер, где создана группа рассылки.

OverrideRecipientQuotas

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

System.Management.Automation.SwitchParameter

PartnerObjectId

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

System.Guid

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

Параметр PrimarySmtpAddress указывает основной SMTP-адрес возврата электронной почты для группы рассылки. Этот параметр имеет смысл использовать только в том случае, если группа рассылки содержит несколько SMTP-адресов электронной почты.

RoomList

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

System.Management.Automation.SwitchParameter

Параметр RoomList указывает, что все члены группы рассылки являются почтовыми ящиками ресурсов конференц-зала. Можно создать список рассылки для административного здания и добавить все его комнаты в группу рассылки. Группы рассылки на основе списка помещений будут использованы в Microsoft Outlook 2010 для создания списка расположений в зданиях, благодаря чему пользователи смогут выбрать здание и получить информацию о помещениях в здании без необходимости добавления этих помещений в здание индивидуально.

Параметр RoomList нельзя использовать вместе с параметром ExternalManaged.

SamAccountName

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

System.String

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

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

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

SendModerationNotifications

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

Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags

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

  • Always

  • Internal

  • Never

Чтобы отправлять уведомления всем отправителям, установите для этого параметра значение Always.

Присвойте этому параметру значение Internal, если требуется отправлять уведомления только отправителям внутри организации.

Чтобы отключить отправку всех уведомлений о состоянии, установите для этого параметра значение Never.

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

Значение по умолчанию: Never.

Type

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

Microsoft.Exchange.Management.RecipientTasks.GroupType

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

Запись «Группы рассылки» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Примеры

ПРИМЕР 1

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

  • Имя группы — «Managers».

  • Эта группа будет создана в контейнере «Users» домена contoso.com.

  • Параметр SamAccountName группы — «Managers».

  • Тип группы — «Security».

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

ПРИМЕР 2

В этом примере создается группа рассылки ITDepartment и пропускается политика именования.

Скопировать код
New-DistributionGroup -Name "ITDepartment" -IgnoreNamingPolicy