Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-04-22
С помощью командлета Set-MailContact можно изменить существующий контакт с включенной поддержкой почты в службе каталогов Служба каталогов Active Directory.
Синтаксис
Set-MailContact -Identity <MailContactIdParameter>
[-AcceptMessagesOnlyFrom <MultiValuedProperty>]
[-AcceptMessagesOnlyFromDLMembers <MultiValuedProperty>]
[-AcceptMessagesOnlyFromSendersOrMembers
<MultiValuedProperty>] [-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-BypassModerationFromSendersOrMembers <MultiValuedProperty>]
[-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>] [-ExternalEmailAddress
<ProxyAddress>] [-ForceUpgrade <SwitchParameter>]
[-GrantSendOnBehalfTo <MultiValuedProperty>]
[-HiddenFromAddressListsEnabled <$true | $false>]
[-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat
<BinHex | UuEncode | AppleSingle | AppleDouble>] [-MailTip
<String>] [-MailTipTranslations <MultiValuedProperty>]
[-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage
<Unlimited>] [-MaxSendSize <Unlimited>]
[-MessageBodyFormat <Text | Html | TextAndHtml>]
[-MessageFormat <Text | Mime>] [-ModeratedBy
<MultiValuedProperty>] [-ModerationEnabled <$true |
$false>] [-Name <String>] [-PrimarySmtpAddress
<SmtpAddress>] [-RejectMessagesFrom
<MultiValuedProperty>] [-RejectMessagesFromDLMembers
<MultiValuedProperty>] [-RejectMessagesFromSendersOrMembers
<MultiValuedProperty>] [-RemovePicture
<SwitchParameter>] [-RemoveSpokenName
<SwitchParameter>] [-RequireSenderAuthenticationEnabled
<$true | $false>] [-SecondaryAddress <String>]
[-SecondaryDialPlan <UMDialPlanIdParameter>]
[-SendModerationNotifications <Never | Internal | Always>]
[-SimpleDisplayName <String>] [-UMDtmfMap
<MultiValuedProperty>] [-UseMapiRichTextFormat <Never |
Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true
| $false>] [-WhatIf [<SwitchParameter>]]
[-WindowsEmailAddress <SmtpAddress>]
|
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter |
Параметр Identity определяет почтовый контакт. Можно использовать одно из следующих значений:
|
||
AcceptMessagesOnlyFrom |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр AcceptMessagesOnlyFrom определяет пользователей почтовых ящиков, пользователей почты и почтовые контакты, которые могут отправлять сообщения электронной почты данному почтовому контакту. Для этого параметра также можно указать Microsoft Exchange в качестве допустимого получателя. Если настроить почтовый контакт так, чтобы он принимал сообщения только от получателя Microsoft Exchange, он будет получать только системные сообщения. Для допустимых отправителей можно использовать любое из следующих значений:
По умолчанию этот параметр не заполнен. Это значение по умолчанию позволяет почтовому контакту принимать сообщения от всех отправителей. |
||
AcceptMessagesOnlyFromDLMembers |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр AcceptMessagesOnlyFromDLMembers определяет группы рассылки, членам которых разрешается отправлять сообщения электронной почты данному почтовому контакту. Для разрешенных групп рассылки можно использовать любое из следующих значений:
По умолчанию этот параметр не заполнен. Это значение по умолчанию позволяет почтовому контакту принимать сообщения от всех отправителей. |
||
AcceptMessagesOnlyFromSendersOrMembers |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр AcceptMessagesOnlyFromSendersorMembers указывает получателей, которые могут отправлять сообщения электронной почты этому почтовому контакту. Для разрешенных групп рассылки можно использовать любое из следующих значений:
По умолчанию этот параметр не заполнен. Это значение по умолчанию позволяет почтовому контакту принимать сообщения от всех отправителей. |
||
Alias |
Необязательный |
System.String |
Параметр Alias указывает псевдоним контакта с включенной поддержкой почты. Псевдоним может содержать буквы, числа, а также следующие знаки препинания и символы:
|
||
ArbitrationMailbox |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Параметр ArbitrationMailbox указывает почтовый ящик, используемый для управления процессом контроля. |
||
BypassModerationFromSendersOrMembers |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр BypassModerationFromSendersorMembers указывает получателей, сообщения которых не требуют контроля при отправке этому почтовому контакту. Можно использовать любое из следующих значений:
По умолчанию этот параметр не заполнен. Это значение по умолчанию обеспечивает контроль всех сообщений почтового контакта, настроенного на контроль. Отправители, назначенные модераторами для этого почтового контакта, могут отправлять сообщения этому контакту. |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно. |
||
CreateDTMFMap |
Необязательный |
System.Boolean |
Параметр CreateDTMFMap указывает, что для контакта создается сопоставление DTMF. |
||
CustomAttribute1 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute10 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute11 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute12 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute13 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute14 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute15 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute2 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute3 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute4 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute5 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute6 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute7 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute8 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
CustomAttribute9 |
Необязательный |
System.String |
Параметры от CustomAttribute1 до CustomAttribute15 указывают настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
||
DisplayName |
Необязательный |
System.String |
Параметр DisplayName определяет краткое имя для пользователя. |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory. |
||
EmailAddresses |
Необязательный |
Microsoft.Exchange.Data.ProxyAddressCollection |
Параметр EmailAddresses указывает псевдоним электронной почты почтового контакта. Можно использовать любые допустимые типы адресов электронной почты Microsoft Exchange. Для параметра EmailAddresses можно указать список из нескольких значений через запятую.
|
||
EmailAddressPolicyEnabled |
Необязательный |
System.Boolean |
Параметр EmailAddressPolicyEnabled указывает, будут ли автоматически обновляться адреса электронной почты для почтового ящика на основе определенных политик адресов электронной почты. |
||
ExternalEmailAddress |
Необязательный |
Microsoft.Exchange.Data.ProxyAddress |
Параметр ExternalEmailAddress указывает внешний адрес электронной почты получателя. |
||
GrantSendOnBehalfTo |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр GrantSendOnBehalfTo указывает различающиеся имена получателей, которые могут отправлять сообщения от имени этого контакта. |
||
HiddenFromAddressListsEnabled |
Необязательный |
System.Boolean |
С помощью параметра HiddenFromAddressListsEnabled можно
указать, появится ли контакт в списках адресов. Возможные значения
для этого параметра: Значение по умолчанию: |
||
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Служба каталогов Active Directory, которые на текущий момент не относятся к области действия по умолчанию. Для параметра IgnoreDefaultScope действуют следующие ограничения.
|
||
MacAttachmentFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat |
Параметр MacAttachmentFormat указывает для сообщений, отправляемых почтовому контакту, формат вложения операционной системы Apple Macintosh. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение BinHex. Допустимые значения параметра MacAttachmentFormat зависят от параметра MessageFormat. Если параметру MessageFormat присвоено значение Text, этот параметр может принимать только значения BinHex и UuEncode. Если параметру MessageFormat присвоено значение Mime, этот параметр может принимать только значения BinHex, AppleSingle и AppleDouble. |
||
MailTip |
Необязательный |
System.String |
Параметр MailTip указывает сообщение, отображаемое отправителям при редактировании черновика сообщения электронной почты для этого получателя. Размер сообщения MailTip не должен превышать 250 символов. |
||
MailTipTranslations |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр MailTipTranslations указывает дополнительные языки при предоставлении сведений о параметре MailTip для этого получателя на нескольких языках. Для каждого языка необходимо задать языковой стандарт, за которым следует двоеточие и определенное значение параметра MailTip на выбранном языке. Размер каждого значения параметра MailTip не должен превышать 250 символов. Названия нескольких языков могут разделяться запятыми. |
||
MaxReceiveSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
С помощью параметра MaxReceiveSize можно указать максимальный размер сообщений электронной почты, которые могут быть получены, от 1 килобайта (КБ) до 2 097 151 КБ. Если значение этого параметра не указано, ограничение устанавливается в максимальном размере. |
||
MaxRecipientPerMessage |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр MaxRecipientPerMessage указывает максимальное число получателей для сообщений этого почтового контакта. |
||
MaxSendSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
С помощью параметра MaxReceiveSize можно указать максимальный размер сообщений электронной почты, которые могут быть отправлены, от 1 килобайта (КБ) до 2 097 151 КБ. Если значение этого параметра не указано, ограничение устанавливается в максимальном размере. |
||
MessageBodyFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat |
Параметр MessageBodyFormat указывает для сообщений, отправляемых почтовому контакту, формат тела сообщения. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение TextAndHtml. Параметры MessageFormat и MessageBodyFormat взаимозависимы. Если параметру MessageFormat присвоено значение Mime, параметру MessageBodyFormat можно присвоить любое допустимое значение. Однако если параметру MessageFormat присвоено значение Text, параметру MessageBodyFormat можно присвоить только значение Text. Следовательно, если данному параметру необходимо присвоить значение Html или TextAndHtml, параметру MessageFormat следует присвоить значение Mime. |
||
MessageFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MessageFormat |
Параметр MessageFormat задает для сообщений, отправляемых почтовому контакту, формат сообщения. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение Mime. Параметры MessageFormat и MessageBodyFormat взаимозависимы. Если параметру MessageFormat присвоено значение Mime, параметру MessageBodyFormat можно присвоить любое допустимое значение. Однако если параметру MessageFormat присвоено значение Text, параметру MessageBodyFormat можно присвоить только значение Text. Следовательно, если необходимо изменить значение параметра MessageFormat с Mime на Text, необходимо также изменить значение параметра MessageBodyFormat на Text. |
||
ModeratedBy |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ModeratedBy указывает пользователей, ответственных за контроль сообщений, отправляемых контакту с включенной поддержкой почты. Чтобы назначить несколько пользователей, разделяйте пользователей запятыми. Этот параметр обязателен, если для параметра
ModerationEnabled установлено значение |
||
ModerationEnabled |
Необязательный |
System.Boolean |
Параметр ModerationEnabled указывает, включен ли контроль
для контакта с включенной поддержкой почты. Возможные значения для
этого параметра: По умолчанию значение равно |
||
Name |
Необязательный |
System.String |
Параметр Name определяет имя контакта, для которого разрешается использование электронной почты. |
||
PrimarySmtpAddress |
Необязательный |
Microsoft.Exchange.Data.SmtpAddress |
С помощью параметра PrimarySmtpAddress можно указать основной адрес электронной почты SMTP. |
||
RejectMessagesFrom |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
С помощью параметра RejectMessagesFrom можно указать получателей, сообщения от которых будут отклоняться. Для указания получателей можно использовать любое из следующих значений:
По умолчанию этот параметр не заполнен. Это значение по умолчанию позволяет почтовому контакту принимать сообщения от всех отправителей. |
||
RejectMessagesFromDLMembers |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
С помощью параметра RejectMessagesFromDLMembers можно указать членов списка рассылки, сообщения от которых будут отклоняться. Для указания получателей можно использовать любое из следующих значений:
По умолчанию этот параметр не заполнен. Это значение по умолчанию позволяет почтовому контакту принимать сообщения от всех отправителей. |
||
RejectMessagesFromSendersOrMembers |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр RejectMessagesFromSendersOrMembers указывает получателей, которые не могут отправлять сообщения электронной почты этому почтовому контакту. Для указания получателей можно использовать любое из следующих значений:
По умолчанию этот параметр не заполнен. Это значение по умолчанию позволяет почтовому контакту принимать сообщения от всех отправителей. |
||
RemovePicture |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр RemovePicture указывает, требуется ли удалить изображение, добавленное пользователем к почтовому контакту. Файл с изображением может быть добавлен к почтовому контакту с помощью командлета Import-RecipientDataProperty. |
||
RemoveSpokenName |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр RemoveSpokenName указывает, требуется ли удалить произносимое имя пользователя, добавленное пользователем к почтовому контакту. Звуковой файл может быть добавлен к почтовому контакту с помощью командлета Import-RecipientDataProperty. |
||
RequireSenderAuthenticationEnabled |
Необязательный |
System.Boolean |
С помощью параметра RequireSenderAuthenticationEnabled
можно указать, необходимо ли принимать сообщения только от
получателей, прошедших проверку подлинности. Значение по умолчанию:
|
||
SecondaryAddress |
Необязательный |
System.String |
Параметр SecondaryAddress указывает дополнительный адрес, используемый контактом единой системы обмена сообщениями. |
||
SecondaryDialPlan |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Параметр SecondaryDialPlan указывает дополнительную абонентскую группу единой системы обмена сообщениями. Этот параметр позволяет создать адрес дополнительного прокси-сервера. |
||
SendModerationNotifications |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags |
Параметр SendModerationNotifications указывает, отправляется ли пользователям уведомление о состоянии при отправке сообщения контролируемой группе рассылки. Укажите одно из следующих значений:
Чтобы отправлять уведомления всем отправителям, установите для параметра значение «Всегда». Присвойте этому параметру значение «Внутренние», если требуется отправлять уведомления только отправителям внутри организации. Чтобы отключить отправку всех уведомлений о состоянии письма, установите для параметра значение «Никогда».
Значение по умолчанию — «Никогда». |
||
SimpleDisplayName |
Необязательный |
System.String |
Параметр SimpleDisplayName используется для вывода альтернативного описания объекта, когда разрешен только ограниченный набор знаков. Этот ограниченный набор знаков включает знаки с кодами ASCII от 26 до 126 включительно. |
||
UMDtmfMap |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр UMDtmfMap указывает, будет ли создано пользовательское сопоставление DTMF для контакта единой системы обмена сообщениями. |
||
UseMapiRichTextFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat |
Параметр UseMapiRichTextFormat указывает, как будут обрабатываться сообщения в формате MAPI Rich Text Format (RTF) для этого почтового контакта. Установите значение «Never» для этого параметра, чтобы преобразовывать в обычный текст все сообщения, отправленные этому контакту. Установите значение «Always» для этого параметра, чтобы всегда отправлять сообщения этому контакту в формате MAPI RTF. Установите для этого параметра значение «UseDefaultSettings», чтобы определять формат на основе параметров клиента MAPI, отправляющего сообщение. |
||
UsePreferMessageFormat |
Необязательный |
System.Boolean |
Параметр UsePreferMessageFormat указывает, будут ли
параметры формата сообщений, настроенные для почтового контакта,
переопределять глобальные параметры, настроенные для удаленного
домена. Возможные значения для этого параметра: |
||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно. |
||
WindowsEmailAddress |
Необязательный |
Microsoft.Exchange.Data.SmtpAddress |
Параметр WindowsEmailAddress указывает адрес электронной почты Windows для данного почтового ящика. Этот пароль не используется Exchange. |
||
ForceUpgrade |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ForceUpgrade запрещает вывод следующего подтверждения: «Чтобы сохранить изменения, внесенные в объект <имя объекта>, необходимо обновить объект до текущей версии Exchange. После обновления управление этим объектом с помощью предыдущей версии средств управления Exchange будет невозможно. Продолжить обновление и сохранить объект?». Это подтверждение выводится при обновлении почтового контакта, созданного в Exchange Server 2003. Управлять почтовым контактом Exchange 2003 с помощью консоли управления Exchange без обновления версии объекта нельзя. |
Подробное описание
Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Подраздел «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Примеры
ПРИМЕР 1
В этом примере устанавливается значение «john@contoso.com» для внешнего адреса электронной почты сотрудника «John Rodman».
Скопировать код | |
---|---|
Set-MailContact -Identity "John Rodman" -ExternalEmailAddress "john@contoso.com" |