Set-OutboundConnector
Этот командлет доступен только в облачной службе.
Командлет 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.