New-EdgeSubscription
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет New-EdgeSubscription для экспорта файла пограничной подписки с пограничного транспортного сервера и импорта файла пограничной подписки на сервер почтовых ящиков.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-EdgeSubscription
[-AccountExpiryDuration <TimeSpan>]
[-Confirm]
[-CreateInboundSendConnector <Boolean>]
[-CreateInternetSendConnector <Boolean>]
[-DomainController <Fqdn>]
[-FileData <Byte[]>]
[-FileName <LongPath>]
[-Force]
[-Site <AdSiteIdParameter>]
[-WhatIf]
[<CommonParameters>] Описание
Пограничный транспортный сервер не имеет доступа к Active Directory. Все сведения о конфигурации и получателях хранятся в экземпляре служб Active Directory облегченного доступа к каталогу (AD LDS). Командлет New-EdgeSubscription создает файл пограничной подписки, который будет импортирован на сервер почтовых ящиков на сайте Active Directory, на который вы хотите подписаться на этот пограничный транспортный сервер.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-EdgeSubscription -FileName "C:\Data\EdgeSubscription.xml"В этом примере создается файл подписки Edge. Он должен выполняться на пограничном транспортном сервере.
Пример 2
$Temp = [System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"В этом примере файл подписки Edge, созданный в примере 1, импортируется на сайт Active Directory Default-First-Site-Name. Импорт файла подписки Edge завершает процесс подписки Edge. Эту команду необходимо выполнить на сервере почтовых ящиков.
Первая команда считывает данные из файла подписки Edge и сохраняет их во временной переменной в виде объекта данных в байтовом кодировке. Вторая команда завершает процесс подписки Edge.
Пример 3
New-EdgeSubscription -FileData ([System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')) -Site "Default-First-Site-Name"В этом примере также импортируется файл подписки Edge, созданный в примере 1, на сайт Active Directory Default-First-Site-Name. однако конечный результат достигается с помощью одной команды. Эту команду необходимо выполнить на сервере почтовых ящиков.
Параметры
-AccountExpiryDuration
Параметр AccountExpiryDuration указывает, как скоро истечет срок действия учетной записи репликации начальной загрузки EdgeSync (ESBRA), созданной этой командой.
Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.
Значение этого параметра должно быть не менее 00:02:00 или 2 минуты. Значение по умолчанию — 24:00:00 или 24 часа.
| Type: | TimeSpan |
| 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 |
-CreateInboundSendConnector
Параметр CreateInboundSendConnector указывает, следует ли создать соединитель отправки для подключения пограничного транспортного сервера и транспортных серверов-концентраторов. Значение по умолчанию — $true. Адресное пространство соединителя отправки имеет значение "--", интеллектуальные узлы — "--", пограничный транспортный сервер — в качестве исходного сервера, а маршрутизация системы доменных имен (DNS) отключена. Этот параметр используется только при выполнении команды на транспортном сервере-концентраторе.
| 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 |
-CreateInternetSendConnector
Параметр CreateInternetSendConnector указывает, следует ли создать соединитель отправки для подключения к Интернету. Значение по умолчанию — $true. Для адресного пространства соединителя отправки заданы все домены (*), пограничный транспортный сервер — в качестве исходного сервера, а маршрутизация DNS включена. Этот параметр используется только при выполнении команды на транспортном сервере-концентраторе.
| 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 |
-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 |
-FileData
Параметр FileData указывает объект данных в байтовом формате, содержащий сведения о файле подписки Edge.
Допустимое значение для этого параметра требует считывания файла в байтовый объект с использованием следующего синтаксиса: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Эту команду можно использовать в качестве значения параметра или записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную в качестве значения параметра ($data).
Этот параметр можно использовать только при выполнении команды на сервере почтовых ящиков.
| Type: | Byte[] |
| 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 |
-FileName
Параметр FileName указывает полный путь к файлу подписки Edge.
Этот параметр можно использовать только при выполнении этой команды на пограничном транспортном сервере.
| Type: | LongPath |
| 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 |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр полезен в следующих сценариях:
- Обход подтверждения при выполнении скрипта команды Edge Subscription.
- Повторное создание подписки на пограничный транспортный сервер и перезапись существующих сведений о конфигурации.
| Type: | SwitchParameter |
| 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 |
-Site
Параметр Site указывает имя сайта Active Directory, содержащего серверы почтовых ящиков, с которыми связаны пограничные транспортные серверы. Этот параметр используется и требуется только при выполнении команды на сервере почтовых ящиков.
| Type: | AdSiteIdParameter |
| 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.