通过

New-EdgeSubscription

模块:
Exchange PowerShell

此 cmdlet 仅适用于本地 Exchange。

使用 New-EdgeSubscription cmdlet 从边缘传输服务器导出边缘订阅文件，并将边缘订阅文件导入邮箱服务器。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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 cmdlet 会在要订阅此边缘传输服务器的 Active Directory 站点中的邮箱服务器上创建要导入的边缘订阅文件。

您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 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"

本示例将示例 1 中生成的 Edge 订阅文件导入到 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"

本示例还将示例 1 中生成的 Edge 订阅文件导入到 Active Directory 站点 Default-First-Site-Name;但是，最终结果是使用一个命令完成的。 必须在邮箱服务器上运行此命令。

参数

-AccountExpiryDuration

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

AccountExpiryDuration 参数指定此命令创建的 EdgeSync 启动复制帐户 (ESBRA) 过期的时间。

若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。

此参数的值必须至少为 00：02：00 或 2 分钟。 默认值为 24：00：00 或 24 小时。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-CreateInboundSendConnector

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

CreateInboundSendConnector 参数指定是否创建发送连接器来连接边缘传输服务器和中心传输服务器。 默认值为 $true。 发送连接器地址空间设置为“--”，智能主机设置为“--”，边缘传输服务器设置为源服务器，域名系统 (DNS) 路由被禁用。 仅当在中心传输服务器上运行 命令时，才使用此参数。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-CreateInternetSendConnector

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

CreateInternetSendConnector 参数指定是否创建发送连接器以连接到 Internet。 默认值为 $true。 发送连接器地址空间设置为 (*) 的所有域，边缘传输服务器设置为源服务器，并启用 DNS 路由。 仅当在中心传输服务器上运行 命令时，才使用此参数。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainController

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FileData

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

FileData 参数指定包含 Edge 订阅文件信息的字节编码数据对象。

此参数的有效值要求使用以下语法将文件读取到字节编码对象： ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))。 可以使用此命令作为参数值，也可以将输出写入变量 () $data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>') ，并将变量用作参数值 ($data) 。

只有在邮箱服务器上运行 命令时，才能使用此参数。

参数属性

类型:

Byte[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FileName

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

FileName 参数指定 Edge 订阅文件的完整路径。

只有在边缘传输服务器上运行此命令时，才能使用此参数。

参数属性

类型:LongPath
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Force

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

强制开关隐藏警告或确认消息。 不必为此开关指定值。

此开关在以下方案中很有用：

  • 编写 Edge 订阅命令脚本时绕过确认。
  • 重新创建边缘传输服务器订阅并覆盖现有配置信息。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Site

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Site 参数指定 Active Directory 站点的名称，该站点包含与边缘传输服务器关联的邮箱服务器。 仅当在邮箱服务器上运行 命令时，才使用此参数。

参数属性

类型:AdSiteIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。