New-EdgeSubscription
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет New-EdgeSubscription для экспорта файла подписки Edge с транспортного сервера Edge и импорта файла подписки Edge на сервер почтовых ящиков.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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"
В этом примере создается файл подписки Microsoft Edge. Его следует запустить на пограничном транспортном сервере.
Пример 2
$Temp = [System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"
В этом примере импортируется файл подписки Microsoft Edge, созданный в примере 1, на сайт Active Directory Default-First-Site-Name. Импорт файла подписки Microsoft Edge завершает процесс подписки Microsoft Edge. Эту команду необходимо выполнить на сервере почтовых ящиков.
Первая команда считывает данные из файла подписки Edge и сохраняет их во временной переменной как объект данных с байтовой кодировкой. Вторая команда завершает процесс подписки на Microsoft Edge.
Пример 3
New-EdgeSubscription -FileData ([System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')) -Site "Default-First-Site-Name"
В этом примере также импортируется файл подписки Microsoft Edge, созданный в примере 1, на сайт Active Directory Default-First-Site-Name; Однако конечный результат достигается с помощью одной команды. Эту команду необходимо выполнить на сервере почтовых ящиков.
Параметры
-AccountExpiryDuration
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр AccountExpiryDuration указывает, как скоро истекает срок действия учетной записи репликации начальной загрузки EdgeSync (ESBRA), созданной этой командой.
Чтобы указать значение, введите его в виде интервала времени: дд.чч:мм:сс, где дд = дни, чч = часы, мм = минуты и сс = секунды.
Значение для этого параметра должно быть не менее 00:02:00 или 2 минуты. Значение по умолчанию: 24:00:00 или 24 часа.
Свойства параметров
| Тип: | TimeSpan |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CreateInboundSendConnector
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр CreateInboundSendConnector указывает, следует ли создавать соединитель Send для соединения пограничного транспортного сервера и транспортных серверов-концентраторов. Значение по умолчанию — $true. Адресное пространство соединителя отправки имеет значение "--", для главных узлов задано значение "--", пограничный транспортный сервер задается в качестве исходного сервера, а маршрутизация службы доменных имен (DNS) отключена. Этот параметр используется только при выполнении команды на транспортном сервере-концентраторе.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CreateInternetSendConnector
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр CreateInternetSendConnector указывает, следует ли создавать соединитель Send для подключения к Интернету. Значение по умолчанию — $true. Адресное пространство соединителя отправки настроено на все домены (*), пограничный транспортный сервер задается в качестве исходного сервера и включена маршрутизация DNS. Этот параметр используется только при выполнении команды на транспортном сервере-концентраторе.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FileData
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр FileData указывает объект данных с байтовой кодировкой, который содержит сведения о файле подписки Edge.
Допустимое значение этого параметра требует чтения файла в объект с байтовой кодировкой со следующим синтаксисом: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Вы можете использовать эту команду в качестве значения параметра или вы можете записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную как значение параметра ($data).
Этот параметр можно использовать только при запуске команды на сервере почтовых ящиков.
Свойства параметров
| Тип: | Byte[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FileName
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр FileName определяет полный путь к файлу подписки Microsoft Edge.
Этот параметр можно использовать только при выполнении этой команды на пограничном транспортном сервере.
Свойства параметров
| Тип: | LongPath |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот ключ полезен в следующих случаях:
- Обход подтверждения при создании сценария команды подписки Microsoft Edge.
- Воссоздание подписки на пограничный транспортный сервер и перезапись существующих сведений о конфигурации.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Site
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Site задает имя сайта Active Directory, содержащего серверы почтовых ящиков, с которыми связаны пограничные транспортные серверы. Этот параметр используется и требуется только при выполнении команды на сервере почтовых ящиков.
Свойства параметров
| Тип: | AdSiteIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.