Командлет Set-MailUser можно использовать для изменения атрибутов, связанных с почтой, для существующего пользователя в службе каталогов Active Directory.
Синтаксис
set-MailUser -Identity <MailUserIdParameter> [-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>] [-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>] [-WindowsEmailAddress <SmtpAddress>] |
set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-WindowsEmailAddress <SmtpAddress>] |
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
Идентификатор |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter |
Параметр Identity принимает одно из следующих значений:
|
AcceptMessagesOnlyFrom |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Параметр AcceptMessagesOnlyFrom указывает получателей, которым разрешается отправлять данному пользователю почты сообщения электронной почты. Он может принимать любые из следующих значений допустимых отправителей:
По умолчанию этот параметр не заполнен. Это значение по умолчанию позволяет пользователю почтового ящика принимать сообщения от всех получателей. |
AcceptMessagesOnlyFromDLMembers |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Параметр AcceptMessagesOnlyFromDLMembers указывает группы рассылки, которым разрешается отправлять сообщения электронной почты данному пользователю почтового ящика. Для определения разрешенных групп рассылки можно использовать следующие значения:
По умолчанию этот параметр не заполнен. |
псевдоним. |
Дополнительно |
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 указывает, будут ли автоматически обновляться адреса электронной почты для почтового ящика на основе определенных политик адресов электронной почты. Если этот параметр установлен в значение $true, то невозможно использовать параметры PrimarySmtpAddress или WindowsEmailAddress. |
Extensions |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр определяет для пользователя один или несколько добавочных номеров. Если этот параметр задан, все добавочные номера в пределах абонентской группы должны быть уникальными. |
ExternalEmailAddress |
Дополнительно |
Microsoft.Exchange.Data.ProxyAddress |
Параметр ExternalEmailAddress указывает адрес электронной почты вне организации. Сообщения электронной почты, отправляемые пользователю, отправляются на внешний адрес. |
GrantSendOnBehalfTo |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[] |
С помощью параметра GrantSendOnBehalfTo можно указать различающиеся имена получателей, которые могут отправлять сообщения от имени этого пользователя. |
HiddenFromAddressListsEnabled |
Дополнительно |
System.Boolean |
С помощью параметра HiddenFromAddressListsEnabled можно указать, появится ли пользователь в списках адресов. По умолчанию этот параметр имеет значение «$false». |
Instance |
Дополнительно |
Microsoft.Exchange.Data.Directory.Management.MailUser |
Параметр Instance позволяет передавать весь объект в команду для обработки. Главным образом он используется в сценариях, в которых в команду должен быть передан весь объект. |
MacAttachmentFormat |
Дополнительно |
Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat |
Параметр MacAttachmentFormat задает для сообщений, отправляемых пользователю почты, формат вложения операционной системы Apple Macintosh. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение BinHex. Допустимые значения параметра MacAttachmentFormat зависят от параметра MessageFormat. Если параметру MessageFormat присвоено значение Text, этот параметр может принимать только значения BinHex и UUENCODE. Если параметру 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 задает для сообщений, отправляемых пользователю почты, формат тела сообщения. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение 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. |
Имя |
Дополнительно |
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 используется для вывода альтернативного описания объекта, если разрешен только ограниченный набор знаков. Этот ограниченный набор знаков включает набор знаков 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, чтобы параметры формата сообщения, настроенные для почтового контакта, перекрывали все глобальные параметры. |
UserPrincipalName |
Дополнительно |
System.String |
Параметр UserPrincipalName указывает основное имя пользователя для данного пользователя. |
WindowsEmailAddress |
Дополнительно |
Microsoft.Exchange.Data.SmtpAddress |
Параметр WindowsEmailAddress указывает адрес электронной почты Windows для данного почтового ящика. В Exchange этот адрес не используется. |
Подробное описание
Командлет Set-MailUser можно использовать для изменения атрибутов пользователя с включенной поддержкой почты в Active Directory.
Для выполнения командлета Set-MailUser используемой учетной записи необходимо делегировать следующую роль:
- роль администратора получателей Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Примечание. |
---|
Командлетом Set-MailUser изменяются не все атрибуты пользователя. С помощью командлета Set-User можно установить дополнительные атрибуты пользователя, не связанные с электронной почтой. |
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
|
Пример
В этом примере команда Set-MailUser используется для установки адреса электронной почты вне организации, на который отправляется электронная почта пользователя Джона Пиплза с включенной поддержкой почты.
Копировать код | |
---|---|
Set-MailUser john -ExternalEmailAddress john@tailspintoys.com |