New-DeliveryAgentConnector

Этот командлет доступен только в локальной среде Exchange.

Командлет New-DeliveryAgentConnector создает в организации соединитель агента доставки.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

New-DeliveryAgentConnector
   [-Name] <String>
   -AddressSpaces <MultiValuedProperty>
   -DeliveryProtocol <String>
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IsScopedConnector <Boolean>]
   [-MaxConcurrentConnections <Int32>]
   [-MaxMessageSize <Unlimited>]
   [-MaxMessagesPerConnection <Int32>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Описание

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

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

Примеры

Пример 1

New-DeliveryAgentConnector -Name "Contoso X.400 Connector" -AddressSpaces "X400:c=US;a=Fabrikam;p=Contoso;1" -DeliveryProtocol "X.400" -SourceTransportServers Hub01,Hub02,Hub05

В этом примере создается соединитель агента доставки «Contoso X.400 Connector» со следующей конфигурацией:

Соединитель агента доставки размещается на следующих серверах:

  • Hub01
  • Hub02
  • Hub05

Соединитель агента доставки предназначен для обработки подключений X.400 к компании Contoso, которая использует передающую сеть Fabrikam.

Адресное пространство для соединителя равно «c=US;a=Fabrikam;p=Contoso».

Параметры

-AddressSpaces

Параметр AddressSpaces указывает доменные имена, за которые отвечает соединитель агента доставки. Полный синтаксис для ввода адресного пространства: AddressSpaceType:AddressSpace;AddressSpaceCost. Заключите каждое адресное пространство в кавычки (").

Type:MultiValuedProperty
Position:Named
Default value:None
Required:True
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DeliveryProtocol

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

Type:String
Position:Named
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Параметр Enabled указывает, включен ли соединитель агента доставки.

Значение по умолчанию — $true.

Type:Boolean
Position:Named
Default value:None
Required:False
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, соединитель может использоваться всеми серверами почтовых ящиков в организации. Если значение этого параметра $true, соединитель может использоваться только серверами почтовых ящиков на том же сайте Active Directory. Значение по умолчанию — $false.

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

-MaxConcurrentConnections

Параметр MaxConcurrentConnections указывает максимальное число одновременных подключений, принимаемых этим соединителем с указанного IP-адреса. Значение по умолчанию равно 5.

Type:Int32
Position:Named
Default value:None
Required:False
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 Б).

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

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

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

-MaxMessagesPerConnection

Параметр MaxMessagesPerConnection указывает максимальное число сообщений, принимаемых этим соединителем в рамках одного подключения. Соединитель прерывает подключение после достижения этого ограничения, и отправляющий сервер должен инициировать новое подключение для отправки дополнительных сообщений. Значение по умолчанию — 20.

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

-Name

Параметр Name задает имя этого соединителя агента доставки. Длина значения параметра Name не может превышать 64 символа.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceTransportServers

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

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Input types

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

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

Output types

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