Командлет New-Mailbox используется для создания нового пользователя в службе каталогов Active Directory и почтового ящика для этого пользователя.

Синтаксис

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

Параметры

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

Database

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

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Параметр Database указывает, в какой базе данных Exchange будет содержаться почтовый ящик нового пользователя. Можно использовать следующие значения:

  • идентификатор GUID базы данных

  • имя базы данных

  • имя сервера\имя базы данных

  • имя сервера\группа хранения\имя базы данных

Equipment

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

System.Management.Automation.SwitchParameter

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

LinkedDomainController

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

System.String

Параметр LinkedDomainController указывает контроллер домена в лесу, где находится учетная запись пользователя. Контроллер домена в этом лесу используется для получения сведений о безопасности для учетной записи, указанной с помощью параметра LinkedMasterAccount. Этот параметр является обязательным только при создании связанного почтового ящика.

LinkedMasterAccount

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

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Параметр LinkedMasterAccount указывает основную учетную запись в лесу, где находится учетная запись пользователя. Главная учетная запись — учетная запись, с которой будет связан почтовый ящик. Главная учетная запись будет предоставлять доступ к почтовому ящику. Этот параметр является обязательным только при создании связанного почтового ящика. Можно использовать одно из следующих значений:

  • GUID;

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

  • Domain\Account

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

  • LegacyExchangeDN

  • SmtpAddress

  • псевдоним.

Имя

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

System.String

Параметр Name указывает имя пользователя. Это имя, которое отображается в оснастке «Active Directory — пользователи и компьютеры». Кроме того, это имя пользователя, которое отображается в свойствах получателя на вкладке Сведения о пользователе.

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit указывает контейнер, где будет создан пользователь.

Пароль

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

System.Security.SecureString

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

Room

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

System.Management.Automation.SwitchParameter

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

Общий

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

System.Management.Automation.SwitchParameter

Параметр Shared указывает, что создается общий почтовый ящик. Общий почтовый ящик — это почтовый ящик, в который могут входить несколько пользователей. Этот почтовый ящик не связан ни с одним из пользователей, которые могут в него войти. Он связан с отключенной учетной записью пользователя.

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

UserPrincipalName

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

System.String

Параметр UserPrincipalName указывает имя участника-пользователя для данного почтового ящика. Это имя используется для входа. Имя участника-пользователя состоит из имени пользователя и суффикса. Обычно суффикс представляет собой имя домена, к которому относится учетная запись пользователя.

ActiveSyncMailboxPolicy

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

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Параметр ActiveSyncMailboxPolicy указывает политику почтовых ящиков, которую необходимо включить для создаваемого почтового ящика. Если этот параметр не задан, используется политика почтовых ящиков по умолчанию.

псевдоним.

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

System.String

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

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

DisplayName

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

System.String

Параметр DisplayName указывает краткое имя для нового пользователя, создаваемого с этим почтовым ящиком. DisplayName — имя, отображаемое в консоли управления Exchange в группе Настройка получателей. DisplayName также отображается в оснастке «Active Directory — пользователи и компьютеры» на вкладке общих свойств пользователя.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает контроллер домена, который будет использоваться для записи изменений конфигурации в Active Directory. Укажите полное доменное имя нужного контроллера домена.

FirstName

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

System.String

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

Initials

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

System.String

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

LastName

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

System.String

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

LinkedCredential

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

System.Management.Automation.PSCredential

Параметр LinkedCredential указывает учетные данные для доступа к контроллеру домена, заданного параметром LinkedDomainController. Этот параметр является необязательным даже при включении связанного почтового ящика.

ManagedFolderMailboxPolicy

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

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

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

ManagedFolderMailboxPolicyAllowed

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

System.Management.Automation.SwitchParameter

Параметр ManagedFolderMailboxPolicyAllowed пропускает предупреждение о том, что функции управления записями обмена сообщениями не поддерживаются для клиентов электронной почты, использующих версии Microsoft Outlook, предшествующие Outlook 2007. Если политика почтовых ящиков управляемых папок назначена почтовому ящику с использованием параметра ManagedFolderMailboxPolicy, предупреждение появляется по умолчанию, если не используется параметр ManagedFolderMailboxPolicyAllowed.

Примечание.
Клиенты Outlook 2003 с пакетом обновления 3 (SP3) поддерживаются, но с ограниченными функциями управления записями обмена сообщениями.

ResetPasswordOnNextLogon

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

System.Boolean

Если этот параметр имеет значение «$true», параметр ResetPasswordOnNextLogon указывает, что при следующем входе пользователя пароль, указанный в параметре Password, необходимо изменить.

SamAccountName

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

System.String

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

Если этот параметр не указан, Active Directory автоматически создаст имя учетной записи SAM на основе имени участника-пользователя.

TemplateInstance

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

System.Management.Automation.PSObject

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

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

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

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

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

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

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

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

Ошибки

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

 

Исключения

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

 

Пример

В первом примере показано, как создать пользователя Chris Ashton в Active Directory и почтовый ящик для этого пользователя. Этот почтовый ящик расположен в группе хранения Storage Group 1, в почтовой базе данных Mailbox Database 1. При следующем входе необходимо сменить пароль. Чтобы задать значение исходного пароля в этом примере создается переменная «$password», появляется запрос на ввод пароля, а затем этот пароль назначается переменной как объект SecureString.

Во втором примере показано, как создать пользователя в Active Directory и почтовый ящик ресурса для конференц-зала. Почтовый ящик ресурса расположен в группе хранения Storage Group 1, в почтовой базе данных Mailbox Database 1. При следующем входе необходимо сменить пароль. Командная консоль Exchange запросит значение исходного пароля, поскольку оно не указано.

Копировать код
$password = Read-Host "Enter password" -AsSecureString
New-mailbox -UserPrincipalName chris@contoso.com -alias chris -database "Storage Group 1\Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

New-Mailbox -UserPrincipalName confmbx@contoso.com -alias confmbx -name ConfRoomMailbox -database "Storage Group 1\Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true