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

Синтаксис

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

Параметры

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

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)

  • домен\учетная запись

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

  • DN из прежних версий Exchange

  • SMTP-адрес

  • псевдоним

Name

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

System.String

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

Password

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

System.Security.SecureString

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

Room

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

System.Management.Automation.SwitchParameter

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

Shared

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

System.Management.Automation.SwitchParameter

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

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

UserPrincipalName

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

System.String

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

ActiveSyncMailboxPolicy

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

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

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

Alias

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

System.String

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

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

Confirm

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

System.Management.Automation.SwitchParameter

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

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ResetPasswordOnNextLogon

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

System.Boolean

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

SamAccountName

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

System.String

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

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

TemplateInstance

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

System.Management.Automation.PSObject

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

UseRusServer

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

System.String

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

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

Примечание.
Использование управляемых настраиваемых папок относится к расширенным возможностям управления записями сообщений. Для использования почтовых ящиков с политиками, которые включают управляемые настраиваемые папки, требуются клиентская лицензия Exchange Server Enterprise.

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

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

Ошибки

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

 

Исключения

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

 

Пример

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