Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-04-22
Для создания нового пользователя с включенной поддержкой почты используется командлет New-MailUser.
Синтаксис
New-MailUser -Name <String> -ExternalEmailAddress
<ProxyAddress> [-Alias <String>] [-ArbitrationMailbox
<MailboxIdParameter>] [-Confirm [<SwitchParameter>]]
[-DisplayName <String>] [-DomainController <Fqdn>]
[-ExternalDirectoryObjectId <String>] [-FirstName
<String>] [-ImmutableId <String>] [-Initials
<String>] [-LastName <String>] [-MacAttachmentFormat
<BinHex | UuEncode | AppleSingle | AppleDouble>]
[-MessageBodyFormat <Text | Html | TextAndHtml>]
[-MessageFormat <Text | Mime>] [-ModeratedBy
<MultiValuedProperty>] [-ModerationEnabled <$true |
$false>] [-Organization <OrganizationIdParameter>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-OverrideRecipientQuotas <SwitchParameter>]
[-PartnerObjectId <Guid>] [-PrimarySmtpAddress
<SmtpAddress>] [-RemotePowerShellEnabled <$true |
$false>] [-ResetPasswordOnNextLogon <$true | $false>]
[-SamAccountName <String>] [-SendModerationNotifications
<Never | Internal | Always>] [-SKUAssigned <$true |
$false>] [-SKUCapability <None | BPOS_S_Deskless |
BPOS_S_Standard | BPOS_S_Archive | BPOS_L_Standard |
BPOS_B_Standard | TOU_Signed | FederatedUser | Partner_Managed |
MasteredOnPremise | ResourceMailbox | ExcludedFromBackSync |
UMFeatureRestricted>] [-UsageLocation <CountryInfo>]
[-UsePreferMessageFormat <$true | $false>] [-WhatIf
[<SwitchParameter>]]
|
New-MailUser -Name <String> -Password
<SecureString> -WindowsLiveID <WindowsLiveId> [-Alias
<String>] [-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm [<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-EvictLiveId
<SwitchParameter>] [-ExternalDirectoryObjectId
<String>] [-ExternalEmailAddress <ProxyAddress>]
[-FirstName <String>] [-ImmutableId <String>]
[-Initials <String>] [-LastName <String>] [-ModeratedBy
<MultiValuedProperty>] [-ModerationEnabled <$true |
$false>] [-Organization <OrganizationIdParameter>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-OverrideRecipientQuotas <SwitchParameter>]
[-PartnerObjectId <Guid>] [-PrimarySmtpAddress
<SmtpAddress>] [-RemotePowerShellEnabled <$true |
$false>] [-ResetPasswordOnNextLogon <$true | $false>]
[-SamAccountName <String>] [-SendModerationNotifications
<Never | Internal | Always>] [-SKUAssigned <$true |
$false>] [-SKUCapability <None | BPOS_S_Deskless |
BPOS_S_Standard | BPOS_S_Archive | BPOS_L_Standard |
BPOS_B_Standard | TOU_Signed | FederatedUser | Partner_Managed |
MasteredOnPremise | ResourceMailbox | ExcludedFromBackSync |
UMFeatureRestricted>] [-UsageLocation <CountryInfo>]
[-WhatIf [<SwitchParameter>]]
|
New-MailUser -Name <String> -ExternalEmailAddress
<ProxyAddress> -Password <SecureString>
-UserPrincipalName <String> [-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>] [-Confirm
[<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-ExternalDirectoryObjectId
<String>] [-FirstName <String>] [-ImmutableId
<String>] [-Initials <String>] [-LastName
<String>] [-MacAttachmentFormat <BinHex | UuEncode |
AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html
| TextAndHtml>] [-MessageFormat <Text | Mime>]
[-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled
<$true | $false>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas
<SwitchParameter>] [-PartnerObjectId <Guid>]
[-PrimarySmtpAddress <SmtpAddress>] [-RemotePowerShellEnabled
<$true | $false>] [-ResetPasswordOnNextLogon <$true |
$false>] [-SamAccountName <String>]
[-SendModerationNotifications <Never | Internal | Always>]
[-SKUAssigned <$true | $false>] [-SKUCapability <None |
BPOS_S_Deskless | BPOS_S_Standard | BPOS_S_Archive |
BPOS_L_Standard | BPOS_B_Standard | TOU_Signed | FederatedUser |
Partner_Managed | MasteredOnPremise | ResourceMailbox |
ExcludedFromBackSync | UMFeatureRestricted>] [-UsageLocation
<CountryInfo>] [-UsePreferMessageFormat <$true |
$false>] [-WhatIf [<SwitchParameter>]]
|
New-MailUser -Name <String> -FederatedIdentity
<String> -WindowsLiveID <WindowsLiveId> [-Alias
<String>] [-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm [<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-EvictLiveId
<SwitchParameter>] [-ExternalDirectoryObjectId
<String>] [-ExternalEmailAddress <ProxyAddress>]
[-FirstName <String>] [-ImmutableId <String>]
[-Initials <String>] [-LastName <String>] [-ModeratedBy
<MultiValuedProperty>] [-ModerationEnabled <$true |
$false>] [-NetID <NetID>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas
<SwitchParameter>] [-PartnerObjectId <Guid>]
[-PrimarySmtpAddress <SmtpAddress>] [-RemotePowerShellEnabled
<$true | $false>] [-ResetPasswordOnNextLogon <$true |
$false>] [-SamAccountName <String>]
[-SendModerationNotifications <Never | Internal | Always>]
[-SKUAssigned <$true | $false>] [-SKUCapability <None |
BPOS_S_Deskless | BPOS_S_Standard | BPOS_S_Archive |
BPOS_L_Standard | BPOS_B_Standard | TOU_Signed | FederatedUser |
Partner_Managed | MasteredOnPremise | ResourceMailbox |
ExcludedFromBackSync | UMFeatureRestricted>] [-WhatIf
[<SwitchParameter>]]
|
New-MailUser -Name <String> -UseExistingLiveId
<SwitchParameter> -WindowsLiveID <WindowsLiveId>
[-Alias <String>] [-ArbitrationMailbox
<MailboxIdParameter>] [-BypassLiveId <SwitchParameter>]
[-Confirm [<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-ExternalDirectoryObjectId
<String>] [-ExternalEmailAddress <ProxyAddress>]
[-FirstName <String>] [-ImmutableId <String>]
[-Initials <String>] [-LastName <String>] [-ModeratedBy
<MultiValuedProperty>] [-ModerationEnabled <$true |
$false>] [-NetID <NetID>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas
<SwitchParameter>] [-PartnerObjectId <Guid>]
[-PrimarySmtpAddress <SmtpAddress>] [-RemotePowerShellEnabled
<$true | $false>] [-ResetPasswordOnNextLogon <$true |
$false>] [-SamAccountName <String>]
[-SendModerationNotifications <Never | Internal | Always>]
[-SKUAssigned <$true | $false>] [-SKUCapability <None |
BPOS_S_Deskless | BPOS_S_Standard | BPOS_S_Archive |
BPOS_L_Standard | BPOS_B_Standard | TOU_Signed | FederatedUser |
Partner_Managed | MasteredOnPremise | ResourceMailbox |
ExcludedFromBackSync | UMFeatureRestricted>] [-UsageLocation
<CountryInfo>] [-WhatIf [<SwitchParameter>]]
|
New-MailUser -Name <String> -ImportLiveId
<SwitchParameter> -WindowsLiveID <WindowsLiveId>
[-Alias <String>] [-ArbitrationMailbox
<MailboxIdParameter>] [-Confirm [<SwitchParameter>]]
[-DisplayName <String>] [-DomainController <Fqdn>]
[-ExternalDirectoryObjectId <String>] [-ExternalEmailAddress
<ProxyAddress>] [-FirstName <String>] [-ImmutableId
<String>] [-Initials <String>] [-LastName
<String>] [-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <$true | $false>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas
<SwitchParameter>] [-PartnerObjectId <Guid>]
[-PrimarySmtpAddress <SmtpAddress>] [-RemotePowerShellEnabled
<$true | $false>] [-ResetPasswordOnNextLogon <$true |
$false>] [-SamAccountName <String>]
[-SendModerationNotifications <Never | Internal | Always>]
[-SKUAssigned <$true | $false>] [-SKUCapability <None |
BPOS_S_Deskless | BPOS_S_Standard | BPOS_S_Archive |
BPOS_L_Standard | BPOS_B_Standard | TOU_Signed | FederatedUser |
Partner_Managed | MasteredOnPremise | ResourceMailbox |
ExcludedFromBackSync | UMFeatureRestricted>] [-UsageLocation
<CountryInfo>] [-WhatIf [<SwitchParameter>]]
|
Параметры
Параметр | Обязательность | Тип | Описание | ||
---|---|---|---|---|---|
ExternalEmailAddress |
Обязательный |
Microsoft.Exchange.Data.ProxyAddress |
Параметр ExternalEmailAddress определяет адрес электронной почты вне организации. Сообщения электронной почты, адресованные пользователю с включенной поддержкой почты, будут отправлены на этот внешний адрес. |
||
FederatedIdentity |
Обязательный |
System.String |
Этот параметр применяется к объектам в облачной службе. В случае локального развертывания он недоступен. Параметр FederatedIdentity связывает пользователя локальной службы Служба каталогов Active Directory с пользователем в облаке. |
||
ImportLiveId |
Обязательный |
System.Management.Automation.SwitchParameter |
Этот параметр применяется к объектам в облачной службе. В случае локального развертывания он недоступен. Параметр ImportLiveID служит для импорта неуправляемого идентификатора Windows Live ID в облачный домен. Неуправляемый идентификатор Windows Live ID создан в домене до регистрации домена в облачной службе. Импорт идентификатора Windows Live ID в домен позволяет сохранить все параметры, связанные с этим идентификатором Windows Live ID, например контакты системы обмена мгновенными сообщениями. Однако к идентификатору Windows Live ID начинают применяться политики безопасности и конфиденциальности, действующие в организации. |
||
Name |
Обязательный |
System.String |
Параметр Name определяет обычное имя (CN) пользователя почты. |
||
Password |
Обязательный |
System.Security.SecureString |
Параметр Password указывает пароль, применяемый пользователем для защиты своей учетной записи. |
||
UseExistingLiveId |
Обязательный |
System.Management.Automation.SwitchParameter |
Этот параметр применяется к объектам в облачной службе. В случае локального развертывания он недоступен. Параметр UseExistingLiveId использует указанный идентификатор Windows Live ID, который уже существует в облачном домене. С этим идентификатором Windows Live ID не может быть связан пользователь почты. |
||
UserPrincipalName |
Обязательный |
System.String |
Параметр UserPrincipalName определяет имя пользователя системы в формате адреса электронной почты (например, ed@contoso.com). |
||
WindowsLiveID |
Обязательный |
Microsoft.Exchange.Data.WindowsLiveId |
Этот параметр применяется к объектам в облачной службе. В случае локального развертывания он недоступен. Параметр WindowsLiveID создает идентификатор Windows Live ID, связанный с пользователем почты. |
||
Alias |
Необязательный |
System.String |
Параметр Alias определяет псевдоним пользователя. Псевдоним может содержать буквы, цифры и следующие знаки и символы:
|
||
ArbitrationMailbox |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Параметр ArbitrationMailbox указывает почтовый ящик, используемый для управления процессом контроля. |
||
BypassLiveId |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно. |
||
DisplayName |
Необязательный |
System.String |
Параметр DisplayName указывает имя, отображаемое в приложении Microsoft Outlook для почтового пользователя. |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory. |
||
EvictLiveId |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр применяется к объектам в облачной службе. В случае локального развертывания он недоступен. Параметр EvictLiveId служит для удаления неуправляемого идентификатора Windows Live ID из облачного домена. Неуправляемый идентификатор Windows Live ID создан в домене до регистрации домена в облачной службе. Исключение идентификатора Windows Live ID из домена позволяет сохранить все параметры, связанные с идентификатором Windows Live ID, например контакты системы обмена мгновенными сообщениями. |
||
ExternalDirectoryObjectId |
Необязательный |
System.String |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
FirstName |
Необязательный |
System.String |
Параметр FirstName указывает имя пользователя почты. |
||
ImmutableId |
Необязательный |
System.String |
Параметр ImmutableId используется средством синхронизации глобальных списков адресов (GALSync) и задает уникальный неизменяемый идентификатор в виде SMTP-адреса для почтового ящика Exchange, используемый для федеративного делегирования при запросе маркеров SAML (Security Assertion Markup Language). Если для почтового ящика настроена федерация и этот параметр не был задан при создании почтового ящика, сервер Exchange создаст значение неизменяемого идентификатора по значению ExchangeGUID почтового ящика и федеративному пространству имен учетных записей, например 7a78e7c8-620e-4d85-99d3-c90d90f29699@mail.contoso.com. Параметр ImmutableId следует задать в случае, если развернуты службы федерации Служба каталогов Active Directory (AD FS), реализующие единый вход в нелокальных почтовых ящиках, и в службах AD FS для запросов маркеров входа настроено использование атрибута, отличного от ExchangeGUID. Как Exchange, так и AD FS должны запрашивать один и тот же маркер для одного пользователя, чтобы гарантировать правильную работу в сценарии нелокального развертывания Exchange. |
||
Initials |
Необязательный |
System.String |
Параметр Initials указывает инициалы пользователя почты. |
||
LastName |
Необязательный |
System.String |
Параметр LastName указывает фамилию пользователя почты. |
||
MacAttachmentFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat |
Параметр MacAttachmentFormat указывает для сообщений, отправляемых пользователю почты, формат вложения операционной системы Apple Macintosh. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение
|
||
MessageBodyFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat |
Параметр MessageBodyFormat задает для сообщений, отправляемых пользователю почты, формат тела сообщения. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение
Параметры MessageFormat и MessageBodyFormat
взаимозависимы. Если для параметра MessageFormat установлено
значение |
||
MessageFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.MessageFormat |
Параметр MessageFormat задает для сообщений, отправляемых пользователю почты, формат сообщения. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение
Параметры MessageFormat и MessageBodyFormat
взаимозависимы. Если для параметра MessageFormat установлено
значение |
||
ModeratedBy |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ModeratedBy определяет пользователей, ответственных за контроль сообщений, отправляемых этому пользователю почты. Чтобы назначить несколько пользователей, разделяйте пользователей запятыми. Этот параметр обязателен, если для параметра
ModerationEnabled установлено значение |
||
ModerationEnabled |
Необязательный |
System.Boolean |
Параметр ModerationEnabled указывает, включен ли контроль
для пользователя почты. Два возможных значения для этого параметра:
По умолчанию значение равно |
||
NetID |
Необязательный |
Microsoft.Exchange.Data.NetID |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
Organization |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support. Параметр Organization указывает организацию, в которой будет выполняться это действие. Этот параметр не допускает ввода подстановочных знаков, поэтому необходимо использовать точное название организации. |
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Параметр OrganizationalUnit указывает подразделение, в которое добавляется новый пользователь (например, redmond.contoso.com/contacts). |
||
OverrideRecipientQuotas |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support. |
||
PartnerObjectId |
Необязательный |
System.Guid |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
PrimarySmtpAddress |
Необязательный |
Microsoft.Exchange.Data.SmtpAddress |
Параметр PrimarySmtpAddress указывает основной SMTP-адрес
для пользователя почты. По умолчанию основной SMTP-адрес создается
на основе политики адресов электронной почты по умолчанию. При
указании основного SMTP-адреса с помощью данного параметра команда
присваивает атрибуту пользователя почты
EmailAddressPolicyEnabled значение |
||
RemotePowerShellEnabled |
Необязательный |
System.Boolean |
Параметр RemotePowerShellEnabled указывает, можно ли удаленно использовать PowerShell. Удаленная среда Remote PowerShell необходима для открытия командной консоли Exchange или консоли управления Exchange на сервере почтовых ящиков, транспортном сервере-концентраторе, сервере единой системы обмена сообщениями и сервере клиентского доступа. Удаленный доступ к PowerShell необходим даже при открытии консоли на локальном сервере. Допустимые значения ввода — |
||
ResetPasswordOnNextLogon |
Необязательный |
System.Boolean |
Параметр ResetPasswordOnNextLogon указывает, требуется ли
пользователю изменять пароль при следующем входе в систему. Если
для этого параметра установлено значение |
||
SamAccountName |
Необязательный |
System.String |
Параметр SamAccountName определяет имя для входа, используемое для поддержки клиентов и серверов, работающих под управлением более старых версий операционной системы. Этот атрибут должен содержать менее 20 знаков. Имя учетной записи может содержать буквы, цифры и следующие знаки и символы:
|
||
SendModerationNotifications |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags |
Параметр SendModerationNotifications указывает, отправляется ли пользователям уведомление о состоянии при отправке сообщения контролируемой группе рассылки. Укажите одно из следующих значений:
Чтобы отправлять уведомления всем отправителям, установите для
этого параметра значение Присвойте этому параметру значение Чтобы отключить отправку всех уведомлений о состоянии,
установите для этого параметра значение По умолчанию значение равно
|
||
SKUAssigned |
Необязательный |
System.Boolean |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
SKUCapability |
Необязательный |
Microsoft.Exchange.Data.Directory.Capability |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
UsageLocation |
Необязательный |
Microsoft.Exchange.Data.Directory.CountryInfo |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
UsePreferMessageFormat |
Необязательный |
System.Boolean |
Параметр UsePreferMessageFormat указывает, будут ли
параметры формата сообщения, настроенные для почтового ящика,
переопределять глобальные параметры, настроенные для домена. Чтобы
параметры формата сообщения, настроенные для почтового ящика,
переопределяли любые глобальные параметры, установите для этого
параметра значение |
||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно. |
Подробное описание
Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Подраздел «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
|
Примеры
ПРИМЕР 1
Следующий пример включает в себя две команды.
С помощью первой команды создается пароль
($password
) типа System.Security.SecureString. При
выполнении команды отображается окно «Введите пароль». Введенная
пользователем строка становится новым паролем
($password
).
С помощью второй команды создается объект пользователя с включенной поддержкой почты «Ed Meadows»; новый пароль для этого пользователя с помощью параметра Password. Пользователь Ed работает в компании Tailspin Toys, но поскольку он тесно сотрудничает со служащими корпорации Contoso, ему предоставили адрес электронной почты в домене contoso.com. На сервере Exchange в компании Contoso у него нет почтового ящика. Сообщения электронной почты, отправляемые на адрес пользователя Ed с доменом contoso.com, пересылаются на его внешний адрес Ed@tailspintoys.com.
Скопировать код | |
---|---|
$password = Read-Host "Enter password" -AsSecureString New-MailUser -Name "Ed Meadows" -Password $password -ExternalEmailAddress ed@tailspintoys.com -UserPrincipalName ed@contoso.com -OrganizationalUnit contoso.com |