Для создания нового пользователя с поддержкой почты используется командлет 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. Допустимые значения параметра MacAttachmentFormat зависят от параметра MessageFormat. Если параметру MessageFormat присвоено значение Text, этот параметр может принимать только значения BinHex и UUENCODE. Если параметру MessageFormat присвоено значение Mime, этот параметр может принимать только значения BinHex, AppleSingle и AppleDouble. |
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. |
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 |