Командлет Set-DistributionGroup используется для изменения параметров существующей группы рассылки.
Синтаксис
Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>] |
Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <DistributionGroup>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>] |
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
Идентификатор |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter |
Параметр Identity определяет объект, который необходимо изменить. Параметр Identity может принимать любое из следующих значений для группы рассылки:
Параметр Identity нельзя использовать в сочетании с параметром Instance. |
AcceptMessagesOnlyFrom |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Параметр AcceptMessagesOnlyFrom задает пользователей почтового ящика и контакты с поддержкой электронной почты, которые могут отправлять сообщения электронной почты в эту группу рассылки. Параметр AcceptMessagesOnlyFrom может принимать любое из следующих ниже значений допустимых отправителей:
По умолчанию для этого параметра задано пустое значение. Это означает, что группа рассылки может принимать сообщения от всех пользователей почтового ящика и всех контактов с поддержкой электронной почты. |
AcceptMessagesOnlyFromDLMembers |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Параметр AcceptMessagesOnlyFromDLMembers указывает группы рассылки, которым разрешается отправлять в данную группу рассылки сообщения электронной почты. Для определения разрешенных групп рассылки можно использовать следующие значения:
По умолчанию для этого параметра задано пустое значение. Это означает, что группа рассылки может принимать сообщения ото всех групп рассылки. |
псевдоним. |
Дополнительно |
System.String |
Параметр Alias позволяет задать псевдоним объекта. Значение параметра Alias не может содержать пробелы. |
CreateDTMFMap |
Дополнительно |
System.Boolean |
Этот параметр определяет, что для группы рассылки создается сопоставление DTMF. |
CustomAttribute1 |
Дополнительно |
System.String |
Параметр CustomAttribute1 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute10 |
Дополнительно |
System.String |
Параметр CustomAttribute10 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute11 |
Дополнительно |
System.String |
Параметр CustomAttribute11 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute12 |
Дополнительно |
System.String |
Параметр CustomAttribute12 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute13 |
Дополнительно |
System.String |
Параметр CustomAttribute13 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute14 |
Дополнительно |
System.String |
Параметр CustomAttribute14 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute15 |
Дополнительно |
System.String |
Параметр CustomAttribute15 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute2 |
Дополнительно |
System.String |
Параметр CustomAttribute2 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute3 |
Дополнительно |
System.String |
Параметр CustomAttribute3 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute4 |
Дополнительно |
System.String |
Параметр CustomAttribute4 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute5 |
Дополнительно |
System.String |
Параметр CustomAttribute5 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute6 |
Дополнительно |
System.String |
Параметр CustomAttribute6 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute7 |
Дополнительно |
System.String |
Параметр CustomAttribute7 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute8 |
Дополнительно |
System.String |
Параметр CustomAttribute8 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
CustomAttribute9 |
Дополнительно |
System.String |
Параметр CustomAttribute9 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
DisplayName |
Дополнительно |
System.String |
Параметр DisplayName позволяет задать имя группы рассылки в консоли управления Exchange и в глобальном списке адресов Exchange. |
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
С помощью параметра DomainController можно указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory. |
EmailAddresses |
Дополнительно |
Microsoft.Exchange.Data.ProxyAddressCollection |
Параметр EmailAddresses позволяет задать псевдонимы электронной почты группы рассылки. Могут использоваться любые допустимые типы адресов электронной почты Microsoft Exchange Server 2007. Для параметра EmailAddresses можно указать список из нескольких значений через запятую. |
EmailAddressPolicyEnabled |
Дополнительно |
System.Boolean |
Параметр EmailAddressPolicyEnabled позволяет управлять применением политик адресов электронной почты к данной группе рассылки. Допустимые значения: $true и $false. По умолчанию он имеет значение «$true». По умолчанию к группе рассылки применяются все применимые политики адресов электронной почты. |
ExpansionServer |
Дополнительно |
System.String |
Параметром ExpansionServer задается сервер Exchange, используемый для расширения группы рассылки. Укажите сервер расширения в виде устаревшего различающегося имени Exchange. Поведение по умолчанию — использовать ближайший компьютер Exchange Server 2003 или ближайший сервер Exchange 2007 с установленной ролью сервера узлового транспорта. |
GrantSendOnBehalfTo |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[] |
Параметр GrantSendOnBehalfTo задает пользователя почтового ящика, который может отправлять сообщения от имени данной группы рассылки. Параметр GrantSendOnBehalfTo может принимать любое из следующих значений
По умолчанию для параметра GrantSendOnBehalfTo задано пустое значение. Это означает, что никакой другой пользователь не имеет разрешения на выполнение отправки от имени данной группы рассылки. |
HiddenFromAddressListsEnabled |
Дополнительно |
System.Boolean |
Параметр HiddenFromAddressListsEnabled позволяет скрывать группу рассылки из любого списка адресов Exchange. Допустимые значения: $true и $false. По умолчанию этот параметр имеет значение «$false». |
Instance |
Дополнительно |
Microsoft.Exchange.Data.Directory.Management.DistributionGroup |
Параметр Instance позволяет передавать весь объект в команду для обработки. Главным образом он используется в сценариях, в которых в команду должен быть передан весь объект. Параметр Instance нельзя использовать в сочетании с параметром Identity. |
MaxReceiveSize |
Дополнительно |
Microsoft.Exchange.Data.Unlimited |
С помощью параметра MaxReceiveSize можно указать максимально допустимый размер сообщения электронной почты, отправляемого в данную группу рассылки. При вводе значения укажите единицы измерения:
Значение без указания единицы обрабатывается как количество байт. Допустимыми являются значения от 0 до 2147482624 байт. По умолчанию параметр MaxReceiveSize имеет значение
|
MaxSendSize |
Дополнительно |
Microsoft.Exchange.Data.Unlimited |
С помощью параметра MaxSendSize можно указать максимально допустимый размер сообщения электронной почты, отправляемого из данной группы рассылки. При вводе значения укажите единицы измерения:
Значение без указания единицы обрабатывается как количество байт. Допустимыми являются значения от 0 до 2147482624 байт. По умолчанию параметр MaxSendSize имеет значение
|
Имя |
Дополнительно |
System.String |
Параметром Name указывается имя группы рассылки. Параметр Name указывает имя группы рассылки в оснастке Active Directory «Пользователи и компьютеры», а также в поле Имя группы в консоли управления Exchange, если группа является почтовый. |
PrimarySmtpAddress |
Дополнительно |
Microsoft.Exchange.Data.SmtpAddress |
Параметр PrimarySmtpAddress указывает основной SMTP-адрес возврата электронной почты для группы рассылки. Этот параметр имеет значение, только если группе рассылки назначено несколько адресов электронной почты SMTP. |
RejectMessagesFrom |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Параметром RejectMessagesFrom задаются пользователи почтового ящика и контакты с поддержкой электронной почты, которым запрещено отправлять сообщения электронной почты в данную группу рассылки. Можно использовать любые из следующих значений запрещенных отправителей:
По умолчанию для этого параметра задано пустое значение. Это означает, что группа рассылки может принимать сообщения от всех пользователей почтового ящика и всех контактов с поддержкой электронной почты. |
RejectMessagesFromDLMembers |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Параметр RejectMessagesFromDLMembers указывает группы рассылки, которым не разрешается отправлять в данную группу рассылки сообщения электронной почты. Для определения запрещенных групп рассылки можно использовать следующие значения:
По умолчанию для этого параметра задано пустое значение. Это означает, что группа рассылки может принимать сообщения ото всех групп рассылки. |
ReportToManagerEnabled |
Дополнительно |
System.Boolean |
Параметр ReportToManagerEnabled позволяет отправлять
отчеты о доставке диспетчеру группы рассылки. Допустимые значения:
$true и $false. Значением по умолчанию является
$false |
ReportToOriginatorEnabled |
Дополнительно |
System.Boolean |
Параметр ReportToOriginatorEnabled позволяет отправлять отчеты о доставке отправителям сообщений электронной почты в данную группу рассылки. Допустимые значения: $true и $false. По умолчанию он имеет значение «$true». |
RequireSenderAuthenticationEnabled |
Дополнительно |
System.Boolean |
Параметр RequireSenderAuthenticationEnabled разрешает доставку сообщений электронной почты только от авторизованных отправителей. Если параметр имеет значение $true, сообщения принимаются только от прошедших проверку отправителей. Допустимые значения: $true и $false. По умолчанию он имеет значение «$true». |
SamAccountName |
Дополнительно |
System.String |
Параметром SamAccountName задается имя для клиентов объекта, работающих под управлением более ранних операционных систем. Параметр SamAccountName отображается в Active Directory и в консоли управления Exchange в поле Имя группы (до Windows 2000). |
SendOofMessageToOriginatorEnabled |
Дополнительно |
System.Boolean |
Параметр SendOofMessageToOriginatorEnabled позволяет
отправлять сообщения об отсутствии на работе отправителям сообщений
электронной почты в данную группу рассылки. Допустимые значения:
|
SimpleDisplayName |
Дополнительно |
System.String |
Параметр SimpleDisplayName используется для вывода альтернативного описания объекта, если разрешен только ограниченный набор знаков. Этот ограниченный набор знаков включает набор знаков ASCII от 26 до 126 включительно. |
UMDtmfMap |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр определяет, будет ли создано пользовательское сопоставление DTMF для группы рассылки единой системы обмена сообщениями. |
WindowsEmailAddress |
Дополнительно |
Microsoft.Exchange.Data.SmtpAddress |
Параметр WindowsEmailAddress указывает значение поля Электронная почта объекта Active Directory. |
Подробное описание
Группы рассылки используются для консолидации групп получателей в одну точку контакта для сообщений электронной почты. Группы рассылки нельзя использовать для назначения разрешений сетевым ресурсам в службе каталогов Active Directory. С помощью командлета Set-DistributionGroup можно переопределять существующие или добавлять новые параметры.
Для выполнения командлета Set-DistributionGroup используемой учетной записи необходимо делегировать следующую роль:
- роль администратора получателей Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Пример
Далее приведен пример программного кода, демонстрирующий использование команды Set-DistributionGroup для изменения краткого имени существующей группы рассылки с имени Accounting на имя Accounting Group.
Копировать код | |
---|---|
Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group" |