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

Синтаксис

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

Параметры

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

ExternalEmailAddress

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

Microsoft.Exchange.Data.ProxyAddress

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

Имя

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

System.String

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

Пароль

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

System.Security.SecureString

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

UserPrincipalName

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

System.String

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

псевдоним.

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

System.String

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

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

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.

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

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

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

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

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

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

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

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

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

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

Ошибки

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

 

Исключения

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

 

Пример

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

В первой команде создается пароль, $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