Командлет 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:
|
||
SamAccountName |
Обязательный |
System.String |
Этот параметр определяет имя для клиентов объекта, работающих под управлением устаревших операционных систем. Параметр SamAccountName выводится в Active Directory и в консоли Exchange в поле Имя группы (до Windows 2000). Если не задан параметр Alias, истинны следующие условия:
|
||
Type |
Обязательный |
Microsoft.Exchange.Management.RecipientTasks.GroupType |
Этот параметр определяет тип группы, создаваемой в
Active Directory. Область группы всегда является
универсальной. Допустимыми являются значения
|
||
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. Для этого параметра можно использовать следующие значения:
|
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Этот параметр определяет, где в Active Directory создавать группу рассылки, используя канонический синтаксис имени. |
||
TemplateInstance |
Необязательный |
System.Management.Automation.PSObject |
Когда в качестве этого параметра используется существующий объект, командлет использует этот объект для создания копии объекта. |
||
UseRusServer |
Необязательный |
System.String |
Параметр 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" |