New-Mailbox
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2009-05-12
Командлет 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>]]
Подробное описание
Для выполнения командлета New-Mailbox используемой учетной записи необходимо делегировать следующие роли:
роль администратора получателей Exchange.
роль оператора учета для соответствующих контейнеров Active Directory.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
.gif "note") Примечание. |
|---|
| Использование управляемых настраиваемых папок относится к расширенным возможностям управления записями сообщений. Для использования почтовых ящиков с политиками, которые включают управляемые настраиваемые папки, требуются клиентская лицензия Exchange Server Enterprise. |
Параметры
| Параметр | Обязательный | Тип | Описание | ||
|---|---|---|---|---|---|
Database |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Параметр Database указывает, в какой базе данных Exchange будет содержаться почтовый ящик нового пользователя. Можно использовать следующие значения:
|
||
Equipment |
Обязательный |
System.Management.Automation.SwitchParameter |
Параметр Equipment указывает, что типом ресурсов является оборудование, если этот почтовый ящик является почтовым ящиком ресурсов. Этот параметр является обязательным только при создании почтового ящика ресурса. |
||
LinkedDomainController |
Обязательный |
System.String |
Параметр LinkedDomainController указывает контроллер домена в лесу, где находится учетная запись пользователя. Контроллер домена в этом лесу используется для получения сведений о безопасности для учетной записи, указанной с помощью параметра LinkedMasterAccount. Этот параметр является обязательным только при создании связанного почтового ящика. |
||
LinkedMasterAccount |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
Параметр LinkedMasterAccount указывает основную учетную запись в лесу, где находится учетная запись пользователя. Главная учетная запись — учетная запись, с которой будет связан почтовый ящик. Главная учетная запись будет предоставлять доступ к почтовому ящику. Этот параметр является обязательным только при создании связанного почтового ящика. Можно использовать одно из следующих значений:
|
||
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.
|
||
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 |
Параметр UseRusServer указывает на необходимость использования определенного сервера почтовых ящиков, на котором выполняется служба списка адресов, для получения и установки атрибутов почтового ящика и пользователя Active Directory. Служба списка адресов является компонентом службы системного помощника Exchange. С ее помощью создаются и поддерживаются характерные для Exchange значения атрибутов в Active Directory. Служба списка адресов позволяет обновлять объекты получателя в домене с использованием определенных сведений, таких как членство в списке адресов и адреса электронной почты. |
||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
Исключения
| Исключения | Описание |
|---|---|
|
Пример
В первом примере показано, как создать пользователя 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