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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.