Set-OutboundConnector

Модуль:

ExchangePowerShell

Применяется к:

Exchange Online, Exchange Online Protection

Этот командлет доступен только в облачной службе.

Командлет Set-OutboundConnector используется для изменения существующего исходящего соединителя в облачной организации.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-OutboundConnector
   [-Identity] <OutboundConnectorIdParameter>
   [-AllAcceptedDomains <Boolean>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-Enabled <Boolean>]
   [-IsTransportRuleScoped <Boolean>]
   [-IsValidated <Boolean>]
   [-LastValidationTimestamp <DateTime>]
   [-Name <String>]
   [-RecipientDomains <MultiValuedProperty>]
   [-RouteAllMessagesViaOnPremises <Boolean>]
   [-SenderRewritingEnabled <Boolean>]
   [-SmartHosts <MultiValuedProperty>]
   [-TestMode <Boolean>]
   [-TlsDomain <SmtpDomainWithSubdomains>]
   [-TlsSettings <TlsAuthLevel>]
   [-UseMXRecord <Boolean>]
   [-ValidationRecipients <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Исходящие соединители отправляют сообщения электронной почты удаленным доменам, для которых требуются особые параметры конфигурации.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1

В этом примере меняются параметры существующего исходящего соединителя Contoso Outbound Connector для маршрутизации на промежуточный узел с IP-адресом 192.168.0.1.

Параметры

-AllAcceptedDomains

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

• $true. Исходящий соединитель используется в гибридных организациях, когда получатели сообщений находятся в принятом домене облачной организации. Для этого параметра для значения ConnectorType требуется OnPremises.
• $false. Исходящий соединитель не используется в гибридных организациях. Это значение используется по умолчанию.

Этот параметр действует только для соединителей OnPremises.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-CloudServicesMailEnabled

Примечание. Рекомендуется не использовать этот параметр, если для этого не будет указано Майкрософт служба поддержки клиентов или документация по конкретному продукту. Вместо этого используйте мастер гибридной конфигурации, чтобы настроить поток обработки почты между локальной и облачной организациями. Дополнительные сведения см. в разделе Мастер гибридной конфигурации.

Параметр CloudServicesMailEnabled указывает, используется ли соединитель для гибридного потока обработки почты между локальной средой Exchange и Майкрософт 365. В частности, этот параметр определяет, как определенные внутренние заголовки сообщений X-MS-Exchange-Organization-* обрабатываются в сообщениях, которые отправляются между принятыми доменами в локальных и облачных организациях. Эти заголовки в совокупности называются межсайтовными заголовками.

Допустимые значения:

• $true. Соединитель используется для потока обработки почты в гибридных организациях, поэтому заголовки между локальными организациями сохраняются или повышаются в сообщениях, проходящих через соединитель. Это значение по умолчанию для соединителей, созданных мастером гибридной конфигурации. Некоторые заголовки X-MS-Exchange-Organization-* в исходящих сообщениях, которые отправляются с одной стороны гибридной организации в другую, преобразуются в заголовки X-MS-Exchange-CrossPremises-* и таким образом сохраняются в сообщениях. Заголовки X-MS-Exchange-CrossPremises-* во входящих сообщениях, которые получаются на одной стороне гибридной организации от другой, повышаются до заголовков X-MS-Exchange-Organization-*. Эти повышенные заголовки заменяют все экземпляры одних и того же заголовка X-MS-Exchange-Organization-*, которые уже существуют в сообщениях.
• $false. Соединитель не используется для потока обработки почты в гибридных организациях, поэтому из сообщений, проходящих через соединитель, удаляются все междометровые заголовки.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Comment

Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-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 Online, Exchange Online Protection

-ConnectorSource

Параметр ConnectorSource указывает, как создается соединитель. Допустимые значения:

• Default: Создание соединителя вручную. Это значение по умолчанию для соединителей, созданных вручную, и мы рекомендуем не изменять это значение.
• HybridWizard: соединитель автоматически создается мастером гибридной конфигурации.
• Migrated: соединитель был создан в Microsoft Forefront Online Protection для Exchange.

Type:	TenantConnectorSource
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ConnectorType

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

• Partner: Соединитель обслуживает домены, находящиеся вне организации.
• OnPremises: Соединитель обслуживает домены, используемые локальной организацией.

Type:	TenantConnectorType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Enabled

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

• $true: соединитель включен. Это значение используется по умолчанию.
• $false: соединитель отключен.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

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

• имя;
• различающееся имя (DN);
• GUID

Type:	OutboundConnectorIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IsTransportRuleScoped

Параметр IsTransportRuleScoped указывает, связан ли исходящий соединитель с правилом транспорта (также известным как правило потока обработки почты). Допустимые значения:

• $true: соединитель связан с правилом транспорта.
• $false: соединитель не связан с правилом транспорта. Это значение используется по умолчанию.

Правило транспорта ограничивается исходящим соединителем с помощью параметра RouteMessageOutboundConnector в New-TransportRule или командлетах Set-TransportRule. Сообщения, соответствующие условиям правила транспорта, направляются в места назначения с помощью указанного исходящего соединителя.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IsValidated

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

• $true: соединитель проверен,
• $false: соединитель не был проверен. Это значение используется по умолчанию.

Используйте командлет Validate-OutboundConnector для проверки соединителя.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-LastValidationTimestamp

Параметр LastValidationTimestamp указывает дату и время проверки исходящего соединителя.

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

• Укажите значение даты и времени в формате UTC. Например, "2021-05-06 14:30:00z".
• Укажите значение даты и времени в качестве формулы, которая преобразует дату и время в местном часовом поясе в utc: например. (Get-Date "5/6/2021 9:30 AM").ToUniversalTime() Для получения дополнительной информации см. Get-Date.

Используйте командлет Validate-OutboundConnector для проверки соединителя.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Name

Параметр Name указывает уникальное имя соединителя. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientDomains

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

Чтобы задать все дочерние домены заданного домена, можно воспользоваться подстановочным знаком, как показано в следующем примере: *.contoso.com. Однако вы не можете внедрить подстановочный знак, как показано в следующем примере: domain.*.contoso.com.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RouteAllMessagesViaOnPremises

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

• $true. Сообщения направляются через локальную систему электронной почты. Для этого параметра для значения ConnectorType требуется OnPremises.
• $false. Сообщения не направляются через локальную систему электронной почты. Это значение используется по умолчанию.

Этот параметр действует только для соединителей OnPremises.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SenderRewritingEnabled

Параметр SenderRewritingEnabled указывает, что все сообщения, которые обычно имеют право на перезапись SRS, перезаписываются для маршрутизации через локальную систему электронной почты. Допустимые значения:

• $true. Сообщения перезаписываются службами SRS по мере необходимости перед маршрутизацией через локальную систему электронной почты. Для этого параметра для значения ConnectorType требуется OnPremises.
• $false: сообщения не переписываются службами SRS перед маршрутизацией через локальную систему электронной почты. Это значение используется по умолчанию.

Этот параметр действует только для соединителей OnPremises.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SmartHosts

Параметр SmartHosts указывает интеллектуальный узел, используемый соединителем исходящего трафика для маршрутизации почты. Допустимые значения:

• Полное доменное имя сервера интеллектуального узла, записи обмена почтой (MX) или записи адреса (A). Например, mail.contoso.com.
• Один IP-адрес: например, 10.10.1.1.
• Диапазон IP-адресов бесклассовой междоменной маршрутизации (CIDR): например, 192.168.0.1/25.

Можно указать несколько значений, разделенных запятыми: "Value1","Value2",..."ValueN".

Этот параметр является обязательным, если для параметра UseMxRecord используется значение $false.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TestMode

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

• $true: включен тестовый режим.
• $false. Тестовый режим отключен. Это значение используется по умолчанию.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TlsDomain

Параметр TlsDomain задает имя домена, которое исходящий соединитель использует для проверки полного доменного имени целевого сертификата при установке соединения, защищенного TLS. Допустимым значением для этого параметра является домен SMTP.

Подстановочные знаки поддерживаются для указания всех поддоменов домена (например, *.contoso.com), но вы не можете внедрить подстановочный знак в домен (например, domain.*.contoso.com).

Этот параметр имеет смысл, только если значение TlsSettings равно DomainValidation.

Type:	SmtpDomainWithSubdomains
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TlsSettings

Параметр TlsSettings задает уровень проверки подлинности TLS, используемый для исходящих соединений TLS, устанавливаемых этим исходящим соединителем. Допустимые значения:

• EncryptionOnly: TLS используется только для шифрования канала связи. Проверка подлинности с помощью сертификатов не выполняется.
• CertificateValidation. ПРОТОКОЛ TLS используется для шифрования проверки каналов и списков отзыва сертификатов.
• DomainValidation. Помимо шифрования каналов и проверки сертификата, исходящий соединитель также проверяет, соответствует ли полное доменное имя целевого сертификата домену, указанному в параметре TlsDomain.
• $null (пусто). Это значение по умолчанию.

Type:	TlsAuthLevel
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-UseMXRecord

Параметр UseMXRecord включает или отключает маршрутизацию DNS для соединителя. Допустимые значения:

• $true. Соединитель использует маршрутизацию DNS (записи MX в DNS) для доставки электронной почты. Это значение используется по умолчанию.
• $false. Соединитель доставляет электронную почту на один или несколько интеллектуальных узлов. Для этого параметра требуется один или несколько интеллектуальных узлов для значения SmartHosts.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ValidationRecipients

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.