Enable-MailContact
Этот командлет доступен только в локальной среде Exchange.
Командлет Enable-MailContact предоставляет возможности почты тем существующим контактам, для которых поддержка почты не включена.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Enable-MailContact
[-Identity] <ContactIdParameter>
-ExternalEmailAddress <ProxyAddress>
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-MacAttachmentFormat <MacAttachmentFormat>]
[-MessageBodyFormat <MessageBodyFormat>]
[-MessageFormat <MessageFormat>]
[-PrimarySmtpAddress <SmtpAddress>]
[-UsePreferMessageFormat <Boolean>]
[-WhatIf]
[<CommonParameters>] Описание
Командлет Enable-MailContact mail-включает существующие контакты, добавляя атрибуты электронной почты, необходимые Exchange. Почтовые контакты видны другим командлетам *-MailContact.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Enable-MailContact -Identity Roland -ExternalEmailAddress "roland@tailspintoys.com"В этом примере включается поддержка почты для существующего контакта, не имеющего такой поддержки.
Параметры
-Alias
Параметр Alias указывает псевдоним Exchange (также называемый почтовым псевдонимом) получателя. Это значение идентифицирует получателя как объект, поддерживающий почту. Не следует путать его с несколькими электронными адресами для одного и того же получателя (также называемыми прокси-адресами). У получателя может быть только одно значение Alias. Максимальная длина: 64 символа.
Значение Alias может содержать буквы, цифры и следующие символы:
- !, #, %, *, +, -, /, =, ?, ^, _, и ~.
- $, &, ', ', {, }и | должны быть экранированы (например
-Alias what`'snew, ) или все значение заключено в одинарные кавычки (например,-Alias 'what'snew'). Символ & не поддерживается в значении Псевдоним для синхронизации Azure AD Connect. - Точки (.) должны быть окружены другими допустимыми символами (например,
help.desk). - Символы Юникода от U+00A1 до U+00FF.
Если при создании получателя не указать электронный адрес, то заданное значение Alias будет использовано для создания основного электронного адреса (alias@domain). Поддерживаемые символы Юникода сопоставляются с наиболее подходящими текстовыми символами US-ASCII. Например, U+00F6 (ö) изменяется на oe в основном адресе электронной почты.
Если при создании получателя не использовать параметр Alias, то в качестве значения свойства Alias будет использовано значение другого обязательного параметра:
- Для получателей с учетными записями пользователей (например, почтовые ящики пользователей и почтовые пользователи) используется левая часть параметра MicrosoftOnlineServicesID или параметр UserPrincipalName. Например, helpdesk@contoso.onmicrosoft.com возвращает значение
helpdeskсвойства Alias . - Получатели без учетных записей пользователей (например, почтовые ящики комнат, почтовые контакты и группы рассылки). Используется значение параметра Name. Пробелы будут удалены, а неподдерживаемые символы преобразованы в знаки вопроса (?).
Если изменить значение параметра Alias существующего получателя, основной электронный адрес будет автоматически обновлен только в локальных средах, где в отношении получателя действуют политики электронных адресов (для получателя свойство EmailAddressPolicyEnabled имеет значение True).
Параметр Alias никогда не создает и не изменяет основной электронный адрес почтового контакта или почтового пользователя.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DisplayName
Параметр DisplayName определяет отображаемое имя почтового контакта. Отображаемое имя показывается в Центре администрирования Exchange и в списках адресов. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalEmailAddress
Параметр ExternalEmailAddress указывает целевой адрес электронной почты почтового контакта или почтового пользователя. По умолчанию это значение используется в качестве основного адреса электронной почты почтового контакта или почтового пользователя.
В локальных средах можно использовать параметр PrimarySMTPAddress, чтобы задать для основного адреса электронной почты другое значение. По умолчанию это значение используется в качестве основного электронного адреса почтового контакта или почтового пользователя.
| Type: | ProxyAddress |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Параметр Identity определяет контакт без поддержки почты, для которого необходимо включить такую поддержку. Можно использовать любое уникальное значение, идентифицирующее контакт. Например:
- имя;
- различающееся имя (DN);
- различающееся имя (DN);
- GUID
| Type: | ContactIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MacAttachmentFormat
Параметр MacAttachmentFormat указывает формат вложения операционной системы Apple Macintosh, который будет использоваться для сообщений, отправляемых почтовому контакту или почтовому пользователю. Допустимые значения:
- BinHex (это значение по умолчанию)
- UuEncode
- AppleSingle
- AppleDouble
Параметры MacAttachmentFormat и MessageFormat являются взаимозависимыми:
- MessageFormat имеет значение Text: MacAttachmentFormat может быть BinHex или UuEncode.
- MessageFormat имеет значение Mime: MacAttachmentFormat может быть BinHex, AppleSingle или AppleDouble.
| Type: | MacAttachmentFormat |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageBodyFormat
Параметр MessageBodyFormat задает формат текста сообщения для сообщений, отправляемых почтовому контакту или почтовому пользователю. Допустимые значения:
- Текст
- HTML
- Html
Параметры MessageFormat и MessageBodyFormat являются взаимозависимыми:
- MessageFormat имеет значение Mime: MessageBodyFormat может быть Text, Html или TextAndHtml.
- MessageFormat имеет значение Text. MessageBodyFormat может быть только Text.
| Type: | MessageBodyFormat |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageFormat
Параметр MessageFormat задает формат сообщений, отправляемых почтовому контакту или почтовому пользователю. Допустимые значения:
- Текст
- Text
Параметры MessageFormat и MessageBodyFormat являются взаимозависимыми:
- MessageFormat имеет значение Mime: MessageBodyFormat может быть Text, Html или TextAndHtml.
- MessageFormat имеет значение Text. MessageBodyFormat может быть только Text.
Таким образом, если необходимо изменить значение параметра MessageFormat с Mime на значение Text, следует изменить значение параметра MessageBodyFormat на значение Text.
| Type: | MessageFormat |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PrimarySmtpAddress
Параметр PrimarySmtpAddress указывает основной обратный электронный адрес, используемый для получателя.
По умолчанию основной адрес совпадает со значением параметра ExternalEmailAddress.
Если вы используете параметр PrimarySmtpAddress для указания основного адреса электронной почты, команда устанавливает для свойства EmailAddressPolicyEnabled почтового контакта значение False, что означает, что адреса электронной почты почтового контакта не обновляются автоматически политиками адресов электронной почты. Рекомендуется не задавать для основного адреса электронной почты значение, отличное от ExternalEmailAddress, если вы не используете сценарий между лесами.
| Type: | SmtpAddress |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UsePreferMessageFormat
UsePreferMessageFormat указывает, переопределяют ли параметры формата сообщений, настроенные для почтового пользователя или почтового контакта, глобальные параметры, настроенные для удаленного домена или отправителем сообщения. Допустимые значения:
- $true. Сообщения, отправляемые почтовому пользователю или почтовому контакту, используют формат сообщения, настроенный для почтового пользователя или почтового контакта.
- $true. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по