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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по