Set-MailUser

  • Статья

 

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

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

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

Синтаксис

set-MailUser -Identity <MailUserIdParameter> [-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>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

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

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

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

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

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

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

noteПримечание.
Командлетом Set-MailUser изменяются не все атрибуты пользователя. С помощью командлета Set-User можно установить дополнительные атрибуты пользователя, не связанные с электронной почтой.

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

У параметра Identity могут быть следующие значения:

  • ADObjectID;

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

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

  • Домен\SamAccountName

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

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

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

  • Псевдоним пользователя.

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

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

EmailAddresses

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

Microsoft.Exchange.Data.ProxyAddressCollection

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

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

EmailAddressPolicyEnabled

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

System.Boolean

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

Extensions

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ExternalEmailAddress

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

Microsoft.Exchange.Data.ProxyAddress

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

GrantSendOnBehalfTo

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

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

HiddenFromAddressListsEnabled

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

System.Boolean

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

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

Instance

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

Microsoft.Exchange.Data.Directory.Management.MailUser

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

MacAttachmentFormat

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

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

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

  • BinHex

  • AppleSingle

  • AppleDouble

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

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

MaxReceiveSize

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

Microsoft.Exchange.Data.Unlimited

С помощью параметра MaxReceiveSize можно указать максимальный размер сообщений электронной почты, которые могут быть получены, от 1 килобайта (КБ) до 2 097 151 КБ.

Если значение этого параметра не указано, то ограничений по размеру не будет.

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.

Name

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

System.String

Параметр Name указывает имя пользователя.

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

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

RecipientLimits

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

Microsoft.Exchange.Data.Unlimited

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

RejectMessagesFrom

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

RejectMessagesFromDLMembers

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

RequireSenderAuthenticationEnabled

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

System.Boolean

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

SamAccountName

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

System.String

Параметр SamAccountName указывает имя для входа, используемое для поддержки клиентов и серверов, работающих под управлением более старых версий операционной системы, например Microsoft Windows NT 4.0, Windows 98, Windows 95 и LAN Manager. Этот атрибут должен содержать менее 20 символов. Имя учетной записи может содержать буквы, числа, а также следующие знаки препинания и символы:

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

SecondaryAddress

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

System.String

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

SecondaryDialPlan

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

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

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

SimpleDisplayName

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

System.String

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

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

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, чтобы параметры формата сообщения, настроенные для почтового контакта, перекрывали все глобальные параметры.

UserPrincipalName

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

System.String

Параметр UserPrincipalName указывает основное имя пользователя для данного пользователя.

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 указывает адрес электронной почты Windows для данного почтового ящика. Exchange этот адрес не использует.

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

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

Ошибки

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

 

Исключения

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

 

Пример

В этом примере команда Set-MailUser используется для установки адреса электронной почты вне организации, на который отправляется электронная почта пользователя Джона Пиплза с включенной поддержкой почты.

Set-MailUser john -ExternalEmailAddress john@tailspintoys.com