Команду New-MailContact можно использовать для создания контакта с включенной электронной почтой.

Синтаксис

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Параметры

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

ExternalEmailAddress

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

Microsoft.Exchange.Data.ProxyAddress

Адрес электронной почты.

Name

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

System.String

Общее имя почтового контакта.

Alias

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

System.String

Псевдоним почтового контакта.

Confirm

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

System.Management.Automation.SwitchParameter

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

DisplayName

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

System.String

Имя для почтового контакта, которое будет отображаться в Microsoft Outlook.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, который записывает изменения этой настройки в службу Active Directory, включите в команду параметр DomainController.

FirstName

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

System.String

Имя почтового контакта.

Initials

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

System.String

Отчество почтового контакта.

LastName

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

System.String

Фамилия почтового контакта.

MacAttachmentFormat

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

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

Параметр MacAttachmentFormat задает для сообщений, отправляемых почтовому контакту, формат вложения операционной системы Apple Macintosh. Допустимые значения этого параметра:

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

По умолчанию этому параметру присвоено значение BinHex.

Допустимые значения параметра MacAttachmentFormat зависят от параметра MessageFormat. Если параметру MessageFormat присвоено значение Text, этот параметр может принимать только значения BinHex и UUENCODE. Если параметру MessageFormat присвоено значение Mime, этот параметр может принимать только значения BinHex, AppleSingle и AppleDouble.

MessageBodyFormat

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

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

Параметр MessageBodyFormat задает для сообщений, отправляемых почтовому контакту, формат текста сообщения. Допустимые значения этого параметра:

  • Text (текстовый)

  • HTML

  • TextAndHtml

По умолчанию этому параметру присвоено значение TextAndHtml.

Параметры MessageFormat и MessageBodyFormat взаимозависимы. Если параметру MessageFormat присвоено значение Mime, параметру MessageBodyFormat можно присвоить любое допустимое значение. Однако если параметру MessageFormat присвоено значение Text, параметру MessageBodyFormat можно присвоить только значение Text. Следовательно, если данному параметру необходимо присвоить значение Html или TextAndHtml, параметру MessageFormat следует присвоить значение Mime.

MessageFormat

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

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

Параметр MessageFormat задает для сообщений, отправляемых почтовому контакту, формат сообщения.

Допустимые значения этого параметра:

  • Text (текстовый)

  • Mime

По умолчанию этому параметру присвоено значение Mime.

Параметры MessageFormat и MessageBodyFormat взаимозависимы. Если параметру MessageFormat присвоено значение Mime, параметру MessageBodyFormat можно присвоить любое допустимое значение. Однако если параметру MessageFormat присвоено значение Text, параметру MessageBodyFormat можно присвоить только значение Text. Следовательно, если необходимо изменить значение параметра MessageFormat с Mime на Text, необходимо также изменить значение параметра MessageBodyFormat на Text.

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Подразделение организации, к которому добавляется новый контакт. Например, redmond.contoso.com/contacts.

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

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

TemplateInstance

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

System.Management.Automation.PSObject

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

UsePreferMessageFormat

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

System.Boolean

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

UseRusServer

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

System.String

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

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Команда New-MailContact создает новый почтовый объект контакта в Microsoft Active Directory, затем включает электронную почту для этого почтового контакта.

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

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

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

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

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

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

Ошибки

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

Исключения

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

Пример

В следующем примере команда New-MailContact используется для создания контакта с включенной электронной почтой.

Копировать код
New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"