Set-DistributionGroup

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2010-10-20

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

Синтаксис

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

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

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

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

  • роль администратора получателей Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, приведены в разделе Вопросы, связанные с разрешениями.

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

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

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

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

  • GUID

  • Имя

  • Краткое имя

  • Псевдоним

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

  • Основной адрес SMTP (Simple Mail Transfer Protocol)

Параметр Identity не может использоваться, если указан параметр Instance.

AcceptMessagesOnlyFrom

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

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

  • GUID

  • Имя

  • Краткое имя

  • Псевдоним

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

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

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

AcceptMessagesOnlyFromDLMembers

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

  • GUID

  • Имя

  • Краткое имя

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

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

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

Alias

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

System.String

Параметр Alias позволяет указать псевдоним объекта. Значение параметра Alias не может содержать пробелы.

Confirm

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

System.Management.Automation.SwitchParameter

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

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

Чтобы указать полное доменное имя (FQDN) контроллера домена, который записывает изменения настройки в Active Directory, включите в команду параметр DomainController.

EmailAddresses

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

Microsoft.Exchange.Data.ProxyAddressCollection

Параметр EmailAddresses позволяет указать псевдонимы электронной почты группы рассылки. Могут использоваться любые допустимые типы адресов электронной почты Microsoft Exchange Server 2007. Для параметра EmailAddresses можно указать список из нескольких значений через запятую.

importantВажно!
Сервер Exchange 2007 не проверяет правильность формата настраиваемых адресов. Пользователи сами должны следить за тем, чтобы указываемые настраиваемые адреса соответствовали требованиям, предъявляемым к формату адресов данного типа. Поскольку в Exchange 2007 адреса X.400 считаются настраиваемыми, они также не проверяются. Следовательно, при указании адреса X.400 необходимо контролировать правильность синтаксиса.

EmailAddressPolicyEnabled

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

System.Boolean

Параметр EmailAddressPolicyEnabled позволяет управлять применением политик адресов электронной почты к данной группе рассылки. Допустимые значения: $true и $false. По умолчанию установлено значение $true. По умолчанию для этой группы рассылки используются все применимые политики адресов электронной почты.

ExpansionServer

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

System.String

Параметром ExpansionServer задается сервер Exchange, используемый для развертывания группы рассылки. Укажите сервер развертывания в виде устаревшего различающегося имени Exchange. По умолчанию используется ближайший компьютер Exchange Server 2003 или ближайший сервер Exchange 2007 с установленной ролью транспортного сервера-концентратора.

GrantSendOnBehalfTo

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

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

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

  • GUID

  • Имя

  • Краткое имя

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

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

  • Псевдоним

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

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

HiddenFromAddressListsEnabled

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

System.Boolean

Параметр HiddenFromAddressListsEnabled позволяет скрывать группу рассылки из любого списка адресов Exchange. Допустимые значения: $true и $false. Значением по умолчанию является $false.

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

  • Использовать параметр DomainController нельзя. Команда автоматически будет использовать подходящий сервер глобального каталога.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

Instance

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

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

Параметр Instance позволяет передать в команду для обработки весь объект. Он обычно используется в сценариях, где команде нужно передать весь объект.

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

ManagedBy

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

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

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

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

  • GUID

  • Имя

  • краткое имя

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

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

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.

Name

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

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

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

UMDtmfMap

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр определяет, будет ли создано пользовательское сопоставление DTMF для группы рассылки единой системы обмена сообщениями.

UseRusServer

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

System.String
noteПримечание.
Этот параметр доступен только в Exchange 2007 с пакетом обновления 2 (SP2).

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

WindowsEmailAddress

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

Microsoft.Exchange.Data.SmtpAddress

Параметр WindowsEmailAddress указывает значение поля Электронная почта объекта Active Directory.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

Далее приведен пример программного кода, демонстрирующий использование команды Set-DistributionGroup для изменения краткого имени существующей группы рассылки с имени Accounting на имя Accounting Group.

Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"