Поделиться через


Командлет New-MailContact (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-05

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

Синтаксис

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

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

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

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

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

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

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

Параметры

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

ExternalEmailAddress

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

Microsoft.Exchange.Data.ProxyAddress

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

Имя

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

System.String

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

псевдоним.

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

System.String

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

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.

TemplateInstance

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

System.Management.Automation.PSObject

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

UsePreferMessageFormat

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

System.Boolean

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

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

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

Ошибки

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

Исключения

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

Пример

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

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"