Команду 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. Допустимые значения параметра 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. |
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Подразделение организации, к которому добавляется новый контакт. Например, redmond.contoso.com/contacts. |
||
PrimarySmtpAddress |
Необязательный |
Microsoft.Exchange.Data.SmtpAddress |
Этот параметр используется для указания основного SMTP-адреса
для почтового контакта. По умолчанию основной SMTP-адрес создается
на основе политики адресов электронной почты по умолчанию. При
указании основного SMTP-адреса с помощью данного параметра,
командлет присвоит атрибуту почтового контакта
EmailAddressPolicyEnabled значение |
||
TemplateInstance |
Необязательный |
System.Management.Automation.PSObject |
Когда этому параметру передается существующий объект, команда использует настройку объекта для создания точной копии этого объекта на локальном или целевом сервере. |
||
UsePreferMessageFormat |
Необязательный |
System.Boolean |
При установке значения «true» данный параметр указывает, что параметры формата сообщений, предпочитаемые пользователем, будут замещать глобальные параметры почты, которую получает данный пользователь. |
||
UseRusServer |
Необязательный |
System.String |
Параметр 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" |