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


Командлет Set-ForeignConnector (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-11

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

Синтаксис

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

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Instance <ForeignConnector>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

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

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

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

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

Параметры

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

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

Обязательность

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

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

  • GUID;

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

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

AddressSpaces

Дополнительно

Microsoft.Exchange.Data.MultiValuedProperty

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

<область_соединителя>:<тип_адресного_пространства>:<адресное_пространство>;<затраты_адресного_пространства>

  • Область_соединителя   Если указано значение Local, соединитель может использоваться только другими транспортными серверами-концентраторами, существующими в том же сайте Active Directory, в качестве исходного транспортного сервера-концентратора, на котором выполняется командлет New-SendConnector. Если квалификатор область_соединителя отсутствует, соединитель может использоваться всеми транспортными серверами-концентраторами всей организации сервера Exchange 2007.

  • Тип_адресного_пространства.   Для адресных пространств SMTP необходимо указать значение «SMTP». Для адресных пространств, не являющихся SMTP, значение может быть любой описательной текстовой строкой, например «Lotus Notes».

  • Адресное_пространство   Для адресных пространств SMTP может быть использован подстановочный знак (*) системы имен DNS, как описано в документе RFC 1035, например: *, *.com. или *.contoso.com. Для адресных пространств, не являющихся адресными пространствами SMTP, могут использоваться подстановочные знаки (*) и другие знаки, например: *contoso.com или @contoso.

  • Затраты_адресного_пространства   Допустимый диапазон затрат — от 1 до 100. Чем ниже затраты, тем лучше маршрут. Этот параметр является необязательным. Если квалификатор стоимость_соединителя опустить при вводе адресного пространства с использованием полного синтаксиса, для стоимости соединителя устанавливаются значение 1.

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

  • Соединители с заданной областью имеют квалификатор Local.

  • Имеются адресные пространства, не являющиеся адресными пространствами SMTP.

  • Имеются адресные пространства SMTP с затратами, отличными от 1.

Если в качестве значения параметра AddressSpaces вводится имя домена или список доменных имен, разделенных запятыми, для каждого домена задается адресное пространство SMTP, а затраты приравниваются к 1.

Комментарий

Дополнительно

System.String

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

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.

Включен

Дополнительно

System.Boolean

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

Instance

Дополнительно

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

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

MaxMessageSize

Дополнительно

Microsoft.Exchange.Data.Unlimited

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

  • B (байт)

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

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

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

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

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

Имя

Дополнительно

System.String

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

RelayDsnRequired

Дополнительно

System.Boolean

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

SourceTransportServers

Дополнительно

Microsoft.Exchange.Data.MultiValuedProperty

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

Пример

Следующий код содержит два примера использования командлета 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"