Применимо к: 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 символа.
Если значения параметров Name и DisplayName различны:
|
||
Alias |
Необязательный |
System.String |
Параметр Alias задает псевдоним группы рассылки. Затем параметр Alias используется для создания основного адреса SMTP электронной почты объекта. Значение параметра Alias не может содержать пробелов. Если параметр Alias не указан, то для создания основного адреса SMTP электронной почты используется значение параметра SamAccountName, причем все пробелы преобразуются в символы подчеркивания. |
||
ArbitrationMailbox |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Параметр ArbitrationMailbox задает почтовый ящик, который используется для управления модерированием. |
||
BypassNestedModerationEnabled |
Необязательный |
System.Boolean |
Параметр BypassNestedModerationEnabled указывает,
разрешено ли родительской группе модераторов утверждать сообщения
для любых вложенных групп, которые также являются модерируемыми.
Если данный параметр установлен как
|
||
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. Если этот параметр не указан, владельцем группы является ее создатель. Чтобы указать получателя, используйте одно из следующих значений:
Чтобы указать пользователя Служба каталогов Active Directory, используйте одно из следующих значений:
Получатели, указанные в параметре ManagedBy, не являются членами группы рассылки. Если необходимо добавить получателей, указанных в этом параметре, как членов группы рассылки, то нужно использовать параметр CopyOwnerToMember. |
||
MemberDepartRestriction |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MemberUpdateType |
Параметр MemberDepartRestriction указывает ограничения, которые накладываются на получателей, которые хотят выйти из группы. Этот параметр может принимать одно из следующих значений:
|
||
MemberJoinRestriction |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MemberUpdateType |
Параметр MemberJoinRestriction указывает ограничения, которые накладываются на получателей, которые хотят присоединиться к группе. Этот параметр может принимать одно из следующих значений:
|
||
Members |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр Members задает начальный список получателей или пользователей Служба каталогов Active Directory, которые входят в данную группу рассылки. Чтобы указать получателя, используйте одно из следующих значений:
Чтобы указать пользователя Служба каталогов Active Directory, используйте одно из следующих значений:
|
||
ModeratedBy |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ModeratedBy указывает пользователей, ответственных за контроль сообщений, отправленных в эту группу. Чтобы указать несколько пользователей, используйте запятые. Параметр ModeratedBy требуется, если для параметра
ModerationEnabled установлено значение |
||
ModerationEnabled |
Необязательный |
System.Boolean |
Параметр ModerationEnabled указывает, включен ли контроль
группы рассылки. Чтобы включить контроль, установите для этого
параметра значение Значение по умолчанию: |
||
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, истинны следующие условия:
|
||
SendModerationNotifications |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags |
Параметр SendModerationNotifications указывает, отправляется ли пользователям уведомление о состоянии при отправке сообщения контролируемой группе рассылки. Допустимо одно из следующих значений:
Чтобы отправлять уведомления всем отправителям, установите для
этого параметра значение Присвойте этому параметру значение Чтобы отключить отправку всех уведомлений о состоянии,
установите для этого параметра значение
Значение по умолчанию: |
||
Type |
Необязательный |
Microsoft.Exchange.Management.RecipientTasks.GroupType |
Параметр Type определяет тип группы, создаваемой в Служба
каталогов Active Directory. Область группы всегда является
универсальной. Допустимыми являются значения
|
||
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 |