Set-ForeignConnector

Синтаксис

Set-ForeignConnector
   [-Identity] <ForeignConnectorIdParameter>
   [-AddressSpaces <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-DropDirectory <String>]
   [-DropDirectoryQuota <Unlimited>]
   [-Enabled <Boolean>]
   [-Force]
   [-IsScopedConnector <Boolean>]
   [-MaxMessageSize <Unlimited>]
   [-Name <String>]
   [-RelayDsnRequired <Boolean>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Внешний соединитель использует транзитный каталог в службе транспорта на сервере почтовых ящиков для отправки сообщений локальному серверу обмена сообщениями, не использующему протокол SMTP в качестве основного механизма транспорта. Такие серверы обработки сообщений называются серверами внешних шлюзов. В качестве примеров серверов внешнего шлюза можно привести серверы шлюза для факсов, разработанные сторонними производителями. Адресные пространства, назначенные внешнему соединителю, могут быть связанными с SMTP или не связанными с SMTP.

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

Примеры

Пример 1

Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB

В этом примере настраивается ограничение размера сообщения до 10 МБ на существующем внешнем соединителе с именем Fax Connector.

Параметры

-— DropDirectory

Параметр DropDirectory указывает имя транзитного каталога, используемого этим внешним соединителем. Все исходящие сообщения, отправляемые в адресные пространства и определенные этим внешним соединителем, помещаются в указанный транзитный каталог. Местоположение транзитного каталога каждого внешнего соединителя определяется следующими двумя элементами:

  • Параметр RootDropDirectoryPath в командлете Set-TransportService: Этот параметр используется для всех внешних соединителей, существующих на сервере почтовых ящиков. Значением параметра Рутдропдиректорипас может быть локальный путь или UNC-путь к удаленному серверу.
  • Параметр DropDirectory в командлете Set-ForeignConnector: Это значение устанавливается для каждого внешнего соединителя, существующего на сервере.

По умолчанию параметр RootDropDirectoryPath не имеет значения. Это означает, что для параметра Рутдропдиректорипас задана папка установки Exchange 2010. По умолчанию для установки Exchange 2010 используется папка C: \ Program Files \ Microsoft \ Exchange Server \ . По умолчанию значением параметра DropDirectory является имя внешнего соединителя.

Если значение параметра DropDirectory не содержит абсолютного пути, расположение транзитного каталога определяется сочетанием параметров DropDirectory и RootDropDirectoryPath. Если значение параметра DropDirectory включает абсолютный путь, значение параметра RootDropDirectoryPath не должно быть указано. Расположение транзитного каталога определяется только значением параметра DropDirectory.

Транзитный каталог не создается автоматически. Поэтому все транзитные каталоги необходимо создать вручную.

Для каталога отброшенных сообщений должны быть заданы следующие разрешения:

  • Сетевая служба: Полный доступ
  • Система: полный доступ
  • Администраторы: полный доступ
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— IsScopedConnector

Параметр IsScopedConnector указывает доступность соединителя для других серверов почтовых ящиков. Если для этого параметра задано значение $false, соединитель может использоваться всеми серверами почтовых ящиков в организации Exchange. Если значение этого параметра равно $true, соединитель можно использовать только на серверах почтовых ящиков на том же сайте Active Directory. Значение по умолчанию: $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— MaxMessageSize

Параметр MaxMessageSize указывает максимальный размер сообщений, которые могут проходить через этот внешний соединитель.

Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

  • Б (байт)
  • КБ (килобайт)
  • МБ (мегабайт)
  • ГБ (гигабайты)
  • ТБ (терабайт)

TB (терабайт)

При вводе значения unlimited для внешнего соединителя не действуют ограничения на размер сообщений. Значение по умолчанию: unlimited. Допустимый диапазон вводимых значений для этого параметра: от 0 до 2147483647 КБ. Если для параметра MaxMessageSize установить значение 0, внешний соединитель будет отключен. Но если для параметра MaxMessageSize установить значение 0, а для атрибута Enabled — $true, это приведет к возникновению ошибок журнала событий. Рекомендуемый способ отключения внешнего соединителя — воспользоваться параметром Enabled.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— SourceTransportServers всех соединителей

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

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

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

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Аддрессспацес

Параметр AddressSpaces указывает доменные имена, на которые отправляет сообщения внешний соединитель. Полный синтаксис для ввода каждого адресного пространства: AddressSpaceType:AddressSpace;AddressSpaceCost .

  • Тип_адресного_пространства: Тип адресного пространства может иметь значение SMTP, X400 или любое другое значение, выраженное текстовой строкой. Если опустить тип адресного пространства, будет использоваться тип адресного пространства SMTP.
  • Адресное_пространство: Для типа адресного пространства SMTP введенное адресное пространство должно соответствовать спецификации RFC 1035. Например, * * разрешены,,. com и * . contoso.com, но * contoso.com не разрешено. Для типов адресного пространства X.400 введенное значение адресного пространства должно соответствовать RFC 1685, например: o=MySite;p=MyOrg;a=adatum;c=us. Для всех остальных типов адреса в качестве адресного пространства можно ввести произвольный текст.
  • Стоимость_адресного_пространства: Диапазон допустимых значений — от 1 до 100. Чем ниже стоимость, тем лучше маршрут. Если опустить значение стоимости адресного пространства, будет использоваться значение 1. Если вводится адресное пространство, не являющееся адресным пространством SMTP и содержащее точку с запятой (;), необходимо указать стоимость адресного пространства.

При указании типа или стоимости адресного пространства необходимо заключить адресное пространство в кавычки ("). Например, следующие записи адресного пространства эквиваленты:

  • "SMTP:contoso. com; 1"
  • "contoso. com; 1"
  • "SMTP:contoso. com"
  • contoso.com

Можно указать несколько адресных пространств, разделяя адресные пространства запятыми, например: contoso.com,fabrikam.com . При указании типа адресного пространства или стоимости адресного пространства необходимо заключить адресное пространство в кавычки ("), например: "contoso.com;2","fabrikam.com;3" .

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

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Дропдиректорикуота

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

Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

  • Б (байт)
  • КБ (килобайт)
  • МБ (мегабайт)
  • ГБ (гигабайты)
  • ТБ (терабайт)

TB (терабайт)

Допустимый диапазон ввода для этого параметра — от 1 до 2 147 483 647 байтов. При вводе значения unlimited для каталога отброшенных сообщений не действуют ограничения на размер сообщений. Значение по умолчанию — unlimited.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Релайдснрекуиред

Параметр RelayDsnRequired указывает, должен ли внешний соединитель отправлять уведомление о доставке при ретрансляции во время записи сообщений в транзитный каталог. Допустимые значения ввода для этого параметра — $true и $false. Значение по умолчанию: $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Comment

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Confirm

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

  • Деструктивные командлеты (например, Remove-* командлеты) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Для этих командлетов вы можете пропустить запрос на подтверждение с помощью этого синтаксиса: -Confirm:$false .
  • Большинство других командлетов (например, New-* и Set-*командлеты) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Пограничные транспортные серверы не поддерживают параметр DomainController. Пограничный транспортный сервер использует локальный экземпляр служб Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

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

  • GUID
  • Имя соединителя
  • ServerName \ коннекторнаме
Type:ForeignConnectorIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Имя

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Принудительно

Параметр Force указывает, следует ли блокировать предупреждающие сообщения или подтверждения. Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора. Указывать значение для этого параметра не обязательно.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-С включенной поддержкой

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

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

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