Командлет 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 может принимать любое из следующих значений для группы рассылки:

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

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

  • GUID;

  • Имя

  • краткое имя

  • псевдоним.

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

  • Первичный SMTP-адрес

Параметр Identity нельзя использовать в сочетании с параметром Instance.

AcceptMessagesOnlyFrom

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

  • GUID;

  • Имя

  • краткое имя

  • псевдоним.

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

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

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

AcceptMessagesOnlyFromDLMembers

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

  • GUID;

  • Имя

  • краткое имя

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

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

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

псевдоним.

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

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 может принимать любое из следующих значений

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

  • GUID;

  • Имя

  • краткое имя

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

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

  • псевдоним.

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

По умолчанию для параметра 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 можно указать максимально допустимый размер сообщения электронной почты, отправляемого в данную группу рассылки. При вводе значения укажите единицы измерения:

  • B (байт)

  • KB (килобайт)

  • MB (мегабайт)

  • GB (гигабайт)

  • TB (терабайт)

Значение без указания единицы обрабатывается как количество байт. Допустимыми являются значения от 0 до 2147482624 байт.

По умолчанию параметр MaxReceiveSize имеет значение unlimited.

MaxSendSize

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

Microsoft.Exchange.Data.Unlimited

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

  • B (байт)

  • KB (килобайт)

  • MB (мегабайт)

  • GB (гигабайт)

  • TB (терабайт)

Значение без указания единицы обрабатывается как количество байт. Допустимыми являются значения от 0 до 2147482624 байт.

По умолчанию параметр MaxSendSize имеет значение unlimited.

Имя

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

System.String

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

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

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

RejectMessagesFrom

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

  • GUID;

  • Имя

  • краткое имя

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

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

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

RejectMessagesFromDLMembers

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

  • GUID;

  • Имя

  • краткое имя

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

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

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

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 позволяет отправлять сообщения об отсутствии на работе отправителям сообщений электронной почты в данную группу рассылки. Допустимые значения: $true и $false. По умолчанию этот параметр имеет значение «$false».

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"