С помощью командлета Set-ForeignConnector можно изменить существующий внешний соединитель на компьютере с установленной ролью сервера концентратора передачи, где выполняется Microsoft Exchange Server 2007. Внешний соединитель использует каталог отброшенных сообщений на сервере концентратора передачи для отправки сообщений на локальный сервер обработки сообщений, который не использует протокол SMTP в качестве основного механизма передачи. Такие серверы обработки сообщений называются серверами внешних шлюзов. В качестве примеров серверов внешнего шлюза можно привести серверы шлюза для факсов, разработанные сторонними производителями. Адресное пространство, назначаемое для внешнего соединителя, может входить или не входить в адресное пространство протокола SMTP.

Синтаксис

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <ForeignConnector>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательный Тип Описание

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

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

  • Идентификатор GUID

  • Имя соединителя

  • имя_сервера\имя_соединителя

AddressSpaces

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр указывает имена доменов, в которые данный внешний соединитель отправляет сообщения. Полный синтаксис для ввода каждого адресного пространства выглядит следующим образом: <тип_адресного_пространства>:<адресное_пространство>;<стоимость_адресного_пространства>

  • Тип_адресного_пространства.   Типу адресного пространства можно присвоить значение 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".

Comment

Необязательный

System.String

Этот параметр указывает необязательный комментарий для внешнего соединителя. Необходимо заключить параметр Comment в двойные кавычки, например: "это примечание администратора".

Confirm

Необязательный

System.Management.Automation.SwitchParameter

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

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы задать полное доменное имя контроллера домена, который записывает изменения настройки в Active Directory, включите в команду параметр DomainController.

DropDirectory

Необязательный

System.String

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

  • Параметр RootDropDirectoryPath командлета Set-TransportServer.   Этот параметр используется для всех внешних соединителей, находящихся на транспортном сервере-концентраторе. В качестве значения параметра RootDropDirectoryPath может быть задан локальный путь или UNC-путь к удаленному серверу.

  • Параметр DropDirectory командлета Set-ForeignConnector.    Это значение задается для каждого внешнего соединителя, находящегося на транспортном сервере-концентраторе.

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

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

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

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

  • Сетевая служба: Полный доступ

  • Система: Полный доступ

  • Администраторы: Полный доступ

DropDirectoryQuota

Необязательный

Microsoft.Exchange.Data.Unlimited

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

  • B (байт)

  • KB (килобайт)

  • MB (мегабайт)

  • GB (гигабайт)

  • TB (терабайт)

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

Enabled

Необязательный

System.Boolean

Этот параметр включает или отключает внешний соединитель. Допустимые значения ввода — $True или $False. Значение по умолчанию — $True.

Force

Необязательный

System.Management.Automation.SwitchParameter

Этот параметр предотвращает вывод предупреждений или подтверждений при выполнении определенных изменений конфигурации.

Instance

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

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

IsScopedConnector

Необязательный

System.Boolean

Этот параметр определяет доступность соединителя для других транспортных серверов-концентраторов. Если этот параметр имеет значение $False, соединитель может использоваться всеми транспортными серверами-концентраторами в организации Exchange. Если этот параметр имеет значение $True, соединитель может использоваться только транспортными серверами-концентраторами на том же сайте Active Directory. По умолчанию используется значение $False.

MaxMessageSize

Необязательный

Microsoft.Exchange.Data.Unlimited

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

  • B (байт)

  • KB (килобайт)

  • MB (мегабайт)

  • GB (гигабайт)

  • TB (терабайт)

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

Name

Необязательный

System.String

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

RelayDsnRequired

Необязательный

System.Boolean

Этот параметр указывает, должен ли внешний соединитель отправлять уведомление о состоянии доставки «Ретрансляции» при записи сообщений в каталог отброшенных сообщений. Допустимые значения ввода для этого параметра — $True и $False. Значение по умолчанию — $False.

SourceTransportServers

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

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

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

Подробное описание

Командлет Set-ForeignConnector изменяет существующий внешний соединитель. Указанные с использованием командлета Set-ForeignConnector изменения свойств переопределяют существующие значения свойств.

Для выполнения командлета Set-ForeignConnector используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.

Пример

Следующий код содержит два примера использования командлета Set-ForeignConnector.

В первом примере показано использование команды Set-ForeignConnector для изменения существующего внешнего соединителя с именем «Contoso Foreign Connector». Эта команда задает для параметра MaxMessageSize значение 10 MB.

Во втором примере показано использование команды Set-ForeignConnector для изменения адресного пространства, обслуживаемого внешним соединителем с именем «Contoso Foreign Connector». Адресные пространства имеют следующие параметры:

  • Первое адресное пространство:

    • Тип адресного пространства: SMTP

    • Адресное пространство: «*.contoso.com»

    • Стоимость адресного пространства: 1

  • Второе адресное пространство:

    • Тип адресного пространства: Lotus Notes

    • Адресное пространство: «*@domino»

    • Стоимость адресного пространства: 55

Копировать код
Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"