Поделиться через


Командлет Set-MailContact (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-05

Командлет Set-MailContact используется для изменения существующего контакта с активированной почтой в службе каталогов Active Directory.

Синтаксис

Set-MailContact -Identity <MailContactIdParameter> [-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>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-WindowsEmailAddress <SmtpAddress>]

Set-MailContact [-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>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-WindowsEmailAddress <SmtpAddress>]

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

С помощью командлета Set-MailContact можно изменять существующий контакт с активированной почтой Active Directory, указав идентификатор контакта и атрибуты, которые нужно изменить.

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

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

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

Параметры

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

Идентификатор

Обязательность

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

Параметр Identity принимает одно из следующих значений:

  • ADObjectID

  • GUID;

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

  • Domain\SamAccountName

  • Имя участника-пользователя

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

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

  • псевдоним контакта

AcceptMessagesOnlyFrom

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

  • GUID;

  • Имя

  • краткое имя

  • псевдоним.

  • Устаревшее различающееся имя Exchange

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

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

AcceptMessagesOnlyFromDLMembers

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

  • GUID;

  • Имя

  • краткое имя

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

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

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

псевдоним.

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

System.String

Параметр 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 определяет краткое имя для пользователя.

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

EmailAddresses

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

Microsoft.Exchange.Data.ProxyAddressCollection

Параметр EmailAddresses указывает адреса электронной почты прокси-серверов списка рассылки.

EmailAddressPolicyEnabled

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

System.Boolean

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

Extensions

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ExternalEmailAddress

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

Microsoft.Exchange.Data.ProxyAddress

Параметр ExternalEmailAddress указывает внешний адрес электронной почты получателя.

GrantSendOnBehalfTo

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

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

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

HiddenFromAddressListsEnabled

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

System.Boolean

С помощью параметра HiddenFromAddressListsEnabled можно указать, появится ли контакт в списках адресов. Если значением является $true, контакт не появится в списке адресов. По умолчанию этот параметр имеет значение «$false».

Instance

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

Microsoft.Exchange.Data.Directory.Management.MailContact

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

MacAttachmentFormat

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

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

Параметр MacAttachmentFormat задает для сообщений, отправляемых почтовому контакту, формат вложения операционной системы Apple Macintosh. Допустимые значения этого параметра:

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

По умолчанию этому параметру присвоено значение BinHex.

Допустимые значения параметра MacAttachmentFormat зависят от параметра MessageFormat. Если параметру MessageFormat присвоено значение Text, этот параметр может принимать только значения BinHex и UUENCODE. Если параметру MessageFormat присвоено значение Mime, этот параметр может принимать только значения BinHex, AppleSingle и AppleDouble.

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

  • Text

  • Html

  • TextAndHtml

По умолчанию этому параметру присвоено значение TextAndHtml.

Параметры MessageFormat и MessageBodyFormat взаимозависимы. Если параметру MessageFormat присвоено значение Mime, параметру MessageBodyFormat можно присвоить любое допустимое значение. Однако если параметру MessageFormat присвоено значение Text, параметру MessageBodyFormat можно присвоить только значение Text. Следовательно, если данному параметру необходимо присвоить значение Html или TextAndHtml, параметру MessageFormat следует присвоить значение Mime.

MessageFormat

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

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

Параметр MessageFormat задает для сообщений, отправляемых почтовому контакту, формат сообщения.

Допустимые значения этого параметра:

  • Text

  • Mime

По умолчанию этому параметру присвоено значение Mime.

Параметры MessageFormat и MessageBodyFormat взаимозависимы. Если параметру MessageFormat присвоено значение Mime, параметру MessageBodyFormat можно присвоить любое допустимое значение. Однако если параметру MessageFormat присвоено значение Text, параметру MessageBodyFormat можно присвоить только значение Text. Следовательно, если необходимо изменить значение параметра MessageFormat с Mime на Text, необходимо также изменить значение параметра MessageBodyFormat на Text.

Имя

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

System.String

Параметр Name определяет имя контакта, для которого разрешается использование электронной почты.

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

С помощью параметра PrimarySmtpAddress можно указать основной адрес электронной почты SMTP.

RejectMessagesFrom

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

RejectMessagesFromDLMembers

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

RequireSenderAuthenticationEnabled

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

System.Boolean

С помощью параметра RequireSenderAuthenticationEnabled можно указать, необходимо ли принимать сообщения только от получателей, прошедших проверку подлинности. По умолчанию этот параметр имеет значение «$false».

SecondaryAddress

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

System.String

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

SecondaryDialPlan

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

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

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

SimpleDisplayName

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

System.String

Параметр SimpleDisplayName используется для вывода альтернативного описания объекта, если разрешен только ограниченный набор знаков. Этот ограниченный набор знаков включает набор знаков ASCII от 26 до 126 включительно.

UMDtmfMap

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

Microsoft.Exchange.Data.MultiValuedProperty

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

UseMapiRichTextFormat

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

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

С помощью параметра UseMapiRichTextFormat можно указать, как будут обрабатываться сообщения в формате MAPI Rich Text Format (RTF) для данного почтового контакта. Установите значение «Never» для этого параметра, чтобы преобразовывать в обычный текст все сообщения, отправленные этому контакту. Установите значение «Always» для этого параметра, чтобы всегда отправлять сообщения этому контакту в формате MAPI RTF. Установите для этого параметра значение «UseDefaultSettings», чтобы определять формат на основе параметров клиента MAPI, отправляющего сообщение.

UsePreferMessageFormat

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

System.Boolean

С помощью параметра UsePreferMessageFormat можно указать, будут ли параметры формата сообщения, настроенные для почтового контакта, перекрывать глобальные параметры, настроенные для удаленного домена. Установите значение $true для этого параметра, чтобы параметры формата сообщения, настроенные для почтового контакта, перекрывали все глобальные параметры.

WindowsEmailAddress

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

Microsoft.Exchange.Data.SmtpAddress

Параметр WindowsEmailAddress указывает адрес электронной почты Windows для данного почтового ящика. В Exchange этот адрес не используется.

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

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

Ошибки

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

 

Исключения

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

 

Пример

В данном примере команда Set-MailContact используется для установки значения john@contoso.com для адреса электронной почты сотрудника John Peoples.

Set-MailContact -Identity "John Peoples" -ExternalEmailAddress "john@contoso.com"