С помощью командлета 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 может принимать любое из следующих значений для объекта внешнего соединителя:
|
AddressSpaces |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр указывает имена доменов, в которые данный внешний соединитель отправляет сообщения. Полный синтаксис для ввода каждого адресного пространства выглядит следующим образом: <тип_адресного_пространства>:<адресное_пространство>;<стоимость_адресного_пространства>
При указании типа или стоимости адресного пространства
необходимо заключить адресное пространство в прямые кавычки
(
Можно указать несколько адресных пространств, разделяя их
запятыми, как показано в следующем примере:
|
Comment |
Необязательный |
System.String |
Этот параметр указывает необязательный комментарий для внешнего соединителя. Необходимо заключить параметр Comment в двойные кавычки, например: "это примечание администратора". |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется. |
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы задать полное доменное имя контроллера домена, который записывает изменения настройки в Active Directory, включите в команду параметр DomainController. |
DropDirectory |
Необязательный |
System.String |
Этот параметр указывает имя каталога отброшенных сообщений, используемого данным внешним соединителем. Все исходящие сообщения, которые отправляются в адресные пространства, определенные данным внешним соединителем, помещаются в указанный каталог отброшенных сообщений. Местоположение транзитного каталога каждого внешнего соединителя определяется следующими двумя элементами:
По умолчанию параметр 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 квалифицируйте это значение одной из следующих единиц измерения:
Значение без указания единицы измерения обрабатывается как
количество байт. Допустимый диапазон ввода для этого параметра — от
|
Enabled |
Необязательный |
System.Boolean |
Этот параметр включает или отключает внешний соединитель.
Допустимые значения ввода — |
Force |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр предотвращает вывод предупреждений или подтверждений при выполнении определенных изменений конфигурации. |
Instance |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector |
Параметр Instance позволяет передать в обрабатываемую команду весь объект. Он обычно используется в сценариях, где целый объект должен быть отправлен команде. |
IsScopedConnector |
Необязательный |
System.Boolean |
Этот параметр определяет доступность соединителя для других
транспортных серверов-концентраторов. Если этот параметр имеет
значение |
MaxMessageSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр указывает максимальный размер почтовых сообщений, которые могут проходить через данный внешний соединитель. При вводе значения параметра MaxMessageSize квалифицируйте его одной из следующих единиц измерения:
Значение без указания единицы измерения обрабатывается как
заданное в килобайтах. При вводе значения |
Name |
Необязательный |
System.String |
Этот параметр указывает понятное имя для внешнего соединителя. |
RelayDsnRequired |
Необязательный |
System.Boolean |
Этот параметр указывает, должен ли внешний соединитель
отправлять уведомление о состоянии доставки «Ретрансляции» при
записи сообщений в каталог отброшенных сообщений. Допустимые
значения ввода для этого параметра — |
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
- Тип адресного пространства: SMTP
- Второе адресное пространство:
- Тип адресного пространства: Lotus Notes
- Адресное пространство: «*@domino»
- Стоимость адресного пространства: 55
- Тип адресного пространства: Lotus Notes
Копировать код | |
---|---|
Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55" |