New-MailContact
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Используйте командлет New-MailContact для создания почтовых контактов.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
New-MailContact
-Name <String>
-ExternalEmailAddress <ProxyAddress>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-FirstName <String>]
[-Initials <String>]
[-LastName <String>]
[-MacAttachmentFormat <MacAttachmentFormat>]
[-MessageBodyFormat <MessageBodyFormat>]
[-MessageFormat <MessageFormat>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-UsePreferMessageFormat <Boolean>]
[-WhatIf]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-MailContact -Name "Chris Ashton" -ExternalEmailAddress "chris@tailspintoys.com"
В этом примере создается новый почтовый контакт с именем Chris Ashton.
Параметры
-Alias
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр Alias указывает псевдоним Exchange (также называемый почтовым псевдонимом) получателя. Это значение идентифицирует получателя как объект, поддерживающий почту. Не следует путать его с несколькими электронными адресами для одного и того же получателя (также называемыми прокси-адресами). У получателя может быть только одно значение Alias. Максимальная длина: 64 символа.
Значение Alias может содержать буквы, цифры и следующие символы:
- !, #, %, *, +, -, /, =, ?, ^, _, и ~.
- $, &, ', ', {, }и | необходимо экранировать (например
-Alias what`'snew, ) или все значение, заключенное в одинарные кавычки (например,-Alias 'what'snew'). Символ & не поддерживается в значении Псевдоним для синхронизации Microsoft Entra 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 никогда не создает и не изменяет основной электронный адрес почтового контакта или почтового пользователя.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ArbitrationMailbox
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр ArbitrationMailbox указывает почтовый ящик разрешения конфликтов, который используется при управлении модерированием для данного получателя. Вы можете использовать любое уникальное значение, идентифицирующее почтовый ящик разрешения конфликтов. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
Свойства параметров
| Тип: | MailboxIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли для этого командлета подтверждение перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Подтвердить без значения приводит к приостановке, которая заставляет подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр DisplayName определяет отображаемое имя почтового контакта. Отображаемое имя показывается в Центре администрирования Exchange и в списках адресов. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Если вы не используете параметр DisplayName, для отображаемого имени указывается значение параметра Name.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalEmailAddress
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр ExternalEmailAddress указывает целевой адрес электронной почты почтового контакта или почтового пользователя. По умолчанию это значение используется в качестве основной адрес электронной почты почтового контакта или почтового пользователя.
В локальных средах можно использовать параметр PrimarySMTPAddress, чтобы задать для основной адрес электронной почты другое значение. По умолчанию это значение используется в качестве основного электронного адреса почтового контакта или почтового пользователя.
Свойства параметров
| Тип: | ProxyAddress |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FirstName
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр FirstName указывает имя пользователя.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Initials
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр Initials указывает отчество пользователя.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LastName
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр LastName указывает фамилию пользователя.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MacAttachmentFormat
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр MacAttachmentFormat указывает формат вложения операционной системы Apple Macintosh, который будет использоваться для сообщений, отправляемых почтовому контакту или почтовому пользователю. Допустимые значения:
- BinHex (значение по умолчанию)
- UuEncode
- AppleSingle
- AppleDouble
Параметры MacAttachmentFormat и MessageFormat являются взаимозависимыми:
- MessageFormat имеет значение Text: MacAttachmentFormat может быть BinHex или UuEncode.
- MessageFormat имеет значение Mime: MacAttachmentFormat может быть BinHex, AppleSingle или AppleDouble.
Свойства параметров
| Тип: | MacAttachmentFormat |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MessageBodyFormat
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр MessageBodyFormat задает формат текста сообщения для сообщений, отправляемых почтовому контакту или почтовому пользователю. Допустимые значения:
- Текст
- HTML
- TextAndHtml (значение по умолчанию)
Параметры MessageFormat и MessageBodyFormat являются взаимозависимыми:
- MessageFormat имеет значение Mime: MessageBodyFormat может быть Text, Html или TextAndHtml.
- MessageFormat имеет значение Text. MessageBodyFormat может быть только Text.
Свойства параметров
| Тип: | MessageBodyFormat |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MessageFormat
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр MessageBodyFormat задает формат текста сообщения для сообщений, отправляемых почтовому контакту или почтовому пользователю. Допустимые значения:
- Текст
- HTML
- TextAndHtml (значение по умолчанию)
Параметры MessageFormat и MessageBodyFormat являются взаимозависимыми:
- MessageFormat имеет значение Mime: MessageBodyFormat может быть Text, Html или TextAndHtml.
- MessageFormat имеет значение Text. MessageBodyFormat может быть только Text.
Свойства параметров
| Тип: | MessageFormat |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModeratedBy
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр ModeratedBy указывает одного или нескольких модераторов для этого почтового контакта. Сообщения, отправленные почтовому контакту, перед доставкой утверждаются модератором. В качестве модератора должен выступать почтовый ящик, почтовый пользователь или почтовый контакт в организации. Для идентификации модератора можно использовать любое уникальное значение. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
С помощью этого параметра необходимо указать как минимум одного модератора, если для параметра ModerationEnabled задано значение $true.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModerationEnabled
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр ModerationEnabled указывает, включена ли модерация для этого получателя. Допустимые значения:
- $true. Для этого получателя включена модерация. Сообщения, отправленные этому получателю, должны быть утверждены модератором перед доставкой сообщений.
- $true. Модерирование включено для этого получателя. Это значение является значением по умолчанию.
Для указания модераторов используется параметр ModeratedBy.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр Name указывает уникальное имя почтового контакта. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Это значение также используется для свойства DisplayName, если не применяется параметр DisplayName.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OrganizationalUnit
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр OrganizationalUnit указывает расположение в Active Directory, где создается новый контакт.
Допустимые значения для этого параметра — подразделение или домен, которые возвращаются с помощью командлета Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:
- Имя
- Имя
- различающееся имя (DN);
- GUID
Свойства параметров
| Тип: | OrganizationalUnitIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PrimarySmtpAddress
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр PrimarySmtpAddress указывает основной обратный электронный адрес, используемый для получателя.
По умолчанию основной адрес совпадает со значением параметра ExternalEmailAddress.
Если вы используете параметр PrimarySmtpAddress для указания основной адрес электронной почты, команда задает для свойства EmailAddressPolicyEnabled почтового контакта значение False, что означает, что адреса электронной почты почтового контакта не обновляются автоматически политиками адресов электронной почты. Не рекомендуется задавать для основной адрес электронной почты значение, отличное от ExternalEmailAddress, если вы не используете сценарий между лесами.
Свойства параметров
| Тип: | SmtpAddress |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SendModerationNotifications
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Службы клиентского доступа выступают в роли прокси-сервера, передавая подключения клиентов во внутренние службы на локальных или удаленных серверах почтовых ящиков. Допустимые значения:
- Всегда: уведомлять всех отправителей о том, что их сообщения не утверждены. Это значение является значением по умолчанию.
- Always. Уведомлять всех отправителей о том, что их сообщения не утверждены. Это значение используется по умолчанию.
- Internal. Уведомлять отправителей вашей организации, если их сообщения не утверждены.
Этот параметр имеет смысл, только если модерация включена (параметр ModerationEnabled имеет значение $true).
Свойства параметров
| Тип: | TransportModerationNotificationFlags |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UsePreferMessageFormat
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
UsePreferMessageFormat указывает, переопределяют ли параметры формата сообщений, настроенные для почтового пользователя или почтового контакта, глобальные параметры, настроенные для удаленного домена или отправителя сообщения. Допустимые значения:
- $true. Сообщения, отправляемые почтовому пользователю или почтовому контакту, используют формат сообщения, настроенный для почтового пользователя или почтового контакта.
- $true. Это значение является значением по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр WhatIf показывает, что выполняет команда, не внося никаких изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.