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

New-MailUser

  • Статья

 

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

Последнее изменение раздела: 2009-05-12

Для создания нового пользователя с поддержкой почты используется командлет New-MailUser.

Синтаксис

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

  • роль оператора учета для соответствующих контейнеров Active Directory.

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

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

Параметры

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

ExternalEmailAddress

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

Microsoft.Exchange.Data.ProxyAddress

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

Name

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

System.String

Параметр Name определяет обычное имя (CN) пользователя почты.

Password

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

System.Security.SecureString

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

UserPrincipalName

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

System.String

Параметр UserPrincipalName определяет имя пользователя системы в формате адреса электронной почты (например, ted@contoso.com).

Alias

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

System.String

Параметр Alias определяет псевдоним пользователя. Псевдоним может содержать буквы, цифры и следующие знаки и символы:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

Confirm

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

System.Management.Automation.SwitchParameter

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

DisplayName

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

System.String

Параметр DisplayName определяет имя пользователя, которое будет показано в Microsoft Outlook.

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

FirstName

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

System.String

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

Initials

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

System.String

Параметр Initials указывает инициалы пользователя почты.

LastName

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

System.String

Параметр LastName указывает фамилию пользователя почты.

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.

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.

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit указывает подразделение, в которое добавляется новый пользователь (например, redmond.contoso.com/contacts).

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

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

ResetPasswordOnNextLogon

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

System.Boolean

Если для параметра ResetPasswordOnNextLogon установлено значение $true, пользователь должен изменить пароль при следующем входе в систему.

SamAccountName

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

System.String

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

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

TemplateInstance

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

System.Management.Automation.PSObject

Если существующий объект поддерживается параметром TemplateInstance, команда будет использовать конфигурацию объекта для создания точной копии объекта на локальном сервере или сервере назначения.

UsePreferMessageFormat

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

System.Boolean

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

UseRusServer

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

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

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Input Types

Return Types

Ошибки

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

 

Исключения

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

 

Пример

Следующий пример состоит из двух команд.

В первой команде создается пароль, $password типа System.Security.SecureString. При выполнении команды появляется окно «Введите пароль». Введенная пользователем строка становится новым паролем, $password.

Вторая команда создает новый пользовательский объект со включенной электронной почтой с именем Ted Bremer и назначает объекту вновь созданный пароль в соответствии с параметром Password. Тэд — сотрудник компании Tailspin Toys, но поскольку он работает вместе с сотрудниками корпорации Contoso, он получил адрес электронной почты contoso.com. У Тэда нет почтового ящика Exchange Server в Contoso. Письма, отправляемые на адрес Тэда contoso.com, отправляются на его внешний адрес электронной почты, ted@tailspintoys.com.

$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com