Командлет 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. Допустимые значения параметра MacAttachmentFormat зависят от параметра MessageFormat. Если параметру MessageFormat присвоено значение Text, этот параметр может принимать только значения BinHex и UUENCODE. Если параметру MessageFormat присвоено значение Mime, этот параметр может принимать только значения BinHex, AppleSingle и AppleDouble. |
MessageBodyFormat |
Дополнительно |
Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat |
Параметр MessageBodyFormat задает для сообщений, отправляемых почтовому контакту, формат текста сообщения. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение TextAndHtml. Параметры MessageFormat и MessageBodyFormat взаимозависимы. Если параметру MessageFormat присвоено значение Mime, параметру MessageBodyFormat можно присвоить любое допустимое значение. Однако если параметру MessageFormat присвоено значение Text, параметру MessageBodyFormat можно присвоить только значение Text. Следовательно, если данному параметру необходимо присвоить значение Html или TextAndHtml, параметру MessageFormat следует присвоить значение Mime. |
MessageFormat |
Дополнительно |
Microsoft.Exchange.Data.Directory.Recipient.MessageFormat |
Параметр MessageFormat задает для сообщений, отправляемых почтовому контакту, формат сообщения. Допустимые значения этого параметра:
По умолчанию этому параметру присвоено значение 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"