Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-24

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

Синтаксис

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ExternalDirectoryObjectId <String>] [-FirstName <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>] [-SendModerationNotifications <Never | Internal | Always>] [-UsePreferMessageFormat <$true | $false>] [-WhatIf [<SwitchParameter>]]

Параметры

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

ExternalEmailAddress

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

Microsoft.Exchange.Data.ProxyAddress

Параметр ExternalEmailAddress определяет целевой адрес электронной почты.

Name

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

System.String

Параметр Name указывает общее имя почтового контакта.

Alias

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

System.String

Параметр Alias указывает псевдоним почтового контакта.

ArbitrationMailbox

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Параметр ArbitrationMailbox указывает почтовый ящик, используемый для управления процессом контроля.

Confirm

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

System.Management.Automation.SwitchParameter

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

DisplayName

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

System.String

Параметр DisplayName указывает имя, отображаемое для почтового контакта в приложении Microsoft Outlook.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.

ExternalDirectoryObjectId

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

System.String

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

FirstName

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

System.String

Параметр FirstName указывает имя почтового контакта.

Initials

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

System.String

Параметр Initials указывает инициалы почтового контакта.

LastName

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

System.String

Параметр LastName указывает фамилию почтового контакта.

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.

ModeratedBy

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

Microsoft.Exchange.Data.MultiValuedProperty

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

Этот параметр обязателен, если для параметра ModerationEnabled установлено значение $true. Если параметр не имеет значения, а в качестве диспетчера данного почтового ящика уже указан пользователь, то параметр ModeratedBy автоматически устанавливается параметром почтового ящика ManagedBy. В противном случае возвращается ошибка.

ModerationEnabled

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

System.Boolean

Параметр ModerationEnabled позволяет включать и отключать контроль над почтовым ящиком. Чтобы включить контроль, установите для этого параметра значение $true. Чтобы отключить контроль, установите для этого параметра значение $false.

Значение по умолчанию: $false.

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support.

Параметр Organization указывает организацию, в которой будет выполняться это действие. Этот параметр не допускает ввода подстановочных знаков, поэтому необходимо использовать точное название организации.

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

OverrideRecipientQuotas

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

System.Management.Automation.SwitchParameter

Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support.

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

Примечание.
Этот параметр не устанавливает квоты. Квоты для почтового контакта необходимо определять с помощью соответствующего командлета Set-MailContact.

PartnerObjectId

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

System.Guid

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

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

SendModerationNotifications

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

Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags

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

  • Always

  • Internal

  • Never

Чтобы отправлять уведомления всем отправителям, установите для этого параметра значение Always.

Установите для данного параметра значение Internal, если уведомления необходимо отправлять только тем отправителям, которые являются внутренними для организации.

Чтобы отключить отправку всех уведомлений о состоянии, установите для этого параметра значение Never.

Значение по умолчанию: Never.

UsePreferMessageFormat

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

System.Boolean

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Подраздел «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Примеры

ПРИМЕР 1

В этом примере создается новый контакт с поддержкой почты, использующий требуемые параметры и параметр OrganizationalUnit.

Скопировать код
New-MailContact -Name "Chris Ashton" -ExternalEmailAddress "Chris@tailspintoys.com" -OrganizationalUnit "Marketing"