Поделиться через


Set-InboundConnector

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

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

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

Синтаксис

Set-InboundConnector
   [-Identity] <InboundConnectorIdParameter>
   [-AssociatedAcceptedDomains <MultiValuedProperty>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-EFSkipIPs <MultiValuedProperty>]
   [-EFSkipLastIP <Boolean>]
   [-EFSkipMailGateway <MultiValuedProperty>]
   [-EFTestMode <Boolean>]
   [-EFUsers <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-Name <String>]
   [-RequireTls <Boolean>]
   [-RestrictDomainsToCertificate <Boolean>]
   [-RestrictDomainsToIPAddresses <Boolean>]
   [-ScanAndDropRecipients <MultiValuedProperty>]
   [-SenderDomains <MultiValuedProperty>]
   [-SenderIPAddresses <MultiValuedProperty>]
   [-TlsSenderCertificateName <TlsCertificate>]
   [-TreatMessagesAsInternal <Boolean>]
   [-TrustedOrganizations <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Описание

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

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

Примеры

Пример 1

Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com

В этом примере вносятся следующие изменения в конфигурацию существующего входящего соединителя с именем Contoso.com Inbound Connector:

Необходимость использования передачи TLS для всех входящих сообщений в соединителе.

Необходимость наличия в сертификате TLS, используемого для шифрования связи, доменного имени contoso.com

Параметры

-AssociatedAcceptedDomains

Параметр AssociatedAcceptedDomains ограничивает исходные домены, использующие соединитель, указанными принятыми доменами. Допустимое значение — это домен SMTP, настроенный в качестве принятого домена в организации Microsoft 365.

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

Type:MultiValuedProperty
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 и Microsoft 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: Соединитель обслуживает домены, используемые локальной организацией. Это значение нужно использовать для обслуживаемых доменов облачной организации, а также его можно задать параметру SenderDomains.
Type:TenantConnectorType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipIPs

Параметр EFSkipIPs указывает исходные IP-адреса, которые следует пропустить в разделе Расширенная фильтрация для соединителей, если значение параметра EFSkipLastIP $false. Допустимые значения:

  • Один IP-адрес: например, 192.168.1.1.
  • Диапазон IP-адресов: например, 192.168.0.1-192.168.0.254.
  • Диапазон IP-адресов бесклассовой междоменной маршрутизации (CIDR): например, 192.168.3.1/24.

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

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

-EFSkipLastIP

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

  • $true. Пропускается только последний источник сообщения.
  • $false: пропустите исходные IP-адреса, указанные параметром EFSkipIPs. Если IP-адреса не указаны, расширенная фильтрация для соединителей отключена на соединителе. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipMailGateway

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

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

-EFTestMode

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

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

-EFUsers

Параметр EFUsers указывает получателей, к которым применяется расширенная фильтрация для соединителей. Значение по умолчанию пустое ($null), что означает, что расширенная фильтрация для соединителей применяется ко всем получателям.

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

Type:MultiValuedProperty
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 указывает изменяемый входящий соединитель.

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

-Name

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

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

-RequireTls

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

  • $true. Отклоняйте сообщения, если они не отправляются по протоколу TLS. Это значение по умолчанию
  • $false. Разрешите сообщения, если они не отправляются по протоколу TLS.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToCertificate

Параметр RestrictDomainsToCertificate указывает, проверяется ли значение Subject сертификата TLS перед тем, как сообщения смогут использовать соединитель. Допустимые значения:

  • $true. Почта может использовать соединитель только в том случае, если значение Subject сертификата TLS, используемого исходным почтовым сервером для проверки подлинности, соответствует значению параметра TlsSenderCertificateName.
  • $false. Значение Subject tls-сертификата, который исходный почтовый сервер использует для проверки подлинности, не определяет, использует ли соединитель почта из этого источника. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToIPAddresses

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

  • $true. Автоматически отклоняет почту из доменов, указанных параметром SenderDomains, если исходный IP-адрес также не указан параметром SenderIPAddress.
  • $false. Не отклоняйте почту из доменов, указанных параметром SenderDomains, на основе исходного IP-адреса. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ScanAndDropRecipients

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

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

-SenderDomains

Параметр SenderDomains указывает исходные домены, для которые соединитель принимает сообщения. Допустимым значением является домен SMTP. Поддерживаются подстановочные знаки для обозначения домена и всех поддоменов (например, *.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

-SenderIPAddresses

Параметр SenderIPAddresses указывает удаленные IP-адреса IPV4, с которых этот соединитель принимает сообщения. IPv6-адреса не поддерживаются. Допустимые значения:

  • Один IP-адрес: например, 192.168.1.1.
  • Диапазон IP-адресов бесклассовой междоменной маршрутизации (CIDR): например, 192.168.0.1/25. Допустимые значения маски подсети: от /24 до /32.

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

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

-TlsSenderCertificateName

Параметр TlsSenderCertificateName указывает сертификат TLS, используемый, если значение параметра RequireTls $true. Допустимым значением является домен SMTP. Поддерживаются подстановочные знаки для обозначения домена и всех поддоменов (например, *.contoso.com), но вы не можете внедрить подстановочный знак (например, domain.*.contoso.com является недопустимым).

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

-TreatMessagesAsInternal

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

  • $true. Сообщения считаются внутренними, если домен отправителя соответствует домену, настроенном в Microsoft 365. Этот параметр разрешает внутренний поток обработки почты между Microsoft 365 и локальными организациями, в которых не установлено Exchange Server 2010 или более поздней версии. Однако этот параметр сопряжен с потенциальными рисками безопасности (например, внутренние сообщения обходят фильтрацию антиспама), поэтому при настройке этого параметра следует соблюдать осторожность.
  • $false. Сообщения не считаются внутренними. Это значение используется по умолчанию.

В гибридных средах использовать этот параметр не требуется, так как мастер гибридной конфигурации автоматически настраивает необходимые параметры для входящего соединителя в Microsoft 365 и соединителя Отправки в локальной организации Exchange (параметр CloudServicesMailEnabled).

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

  • Параметр CloudServicesMailEnabled имеет значение $true.
  • Значение параметра ConnectorType не равно 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

-TrustedOrganizations

Параметр TrustedOrganizations указывает другие организации Microsoft 365, которые являются доверенными источниками почты (например, после приобретения и слияния). Этот параметр работает только для потока обработки почты между двумя организациями Microsoft 365, поэтому другие параметры не используются.

Чтобы ввести несколько значений и перезаписать все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

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