Get-MigrationEndpoint

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。

使用 Get-MigrationEndpoint cmdlet 检索源或目标服务器的迁移终结点设置,以便直接转换或暂存 Exchange 迁移、IMAP 迁移和远程移动。

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

语法

ConnectionSettingsFilter

Get-MigrationEndpoint
    -ConnectionSettings <ExchangeConnectionSettings>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

TypeFilter

Get-MigrationEndpoint
    -Type <MigrationType>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Partition <MailboxIdParameter>]
    [-DiagnosticInfo <String>]
    [<CommonParameters>]

Identity

Get-MigrationEndpoint
    [[-Identity] <MigrationEndpointIdParameter>]
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Partition <MailboxIdParameter>]
    [-DiagnosticInfo <String>]
    [<CommonParameters>]

说明

Get-MigrationEndpoint cmdlet 检索不同类型的迁移的设置:

  • 跨林移动:在两个不同的本地 Exchange 林之间移动邮箱。 跨林移动需要使用 RemoteMove 终结点。
  • 远程移动:在混合部署中,远程移动涉及加入或卸载迁移。 远程移动需要使用 RemoteMove 终结点。 加入会将邮箱从本地 Exchange 组织移动到Exchange Online,并使用 RemoteMove 终结点作为迁移批处理的源终结点。 卸载会将邮箱从 Exchange Online 移动到本地 Exchange 组织,并使用 RemoteMove 终结点作为迁移批处理的目标终结点。
  • 直接转换 Exchange 迁移:将本地 Exchange 组织中的所有邮箱迁移到Exchange Online。 直接转换 Exchange 迁移需要使用 Exchange 终结点。
  • 分阶段 Exchange 迁移:将一部分邮箱从本地 Exchange 组织迁移到Exchange Online。 分阶段 Exchange 迁移需要使用 Exchange 终结点。
  • IMAP 迁移:将邮箱数据从本地 Exchange 组织或其他电子邮件系统迁移到Exchange Online。 对于 IMAP 迁移,必须先创建基于云的邮箱,然后才能迁移邮箱数据。 IMAP 迁移需要使用 IMAP 终结点。
  • 本地:在单个本地 Exchange 林中的不同服务器或数据库之间移动邮箱。 本地移动不需要使用终结点。

有关不同的移动和迁移方案的详细信息,请参阅:

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-MigrationEndpoint -Identity OnboardingME01

此示例检索迁移终结点 OnboardingME01 的设置。

参数

-ConnectionSettings

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

ConnectionSettings 参数指定要为其查找匹配终结点的源或目标服务器的配置设置。

参数属性

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

参数集

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

-Diagnostic

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

Diagnostic 开关指定是否在结果中返回非常详细的信息。 不必为此开关指定值。

通常情况下,仅在应 Microsoft 客户服务和支持部门请求排查问题时,才使用此开关。

参数属性

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

参数集

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

-DiagnosticArgument

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

DiagnosticArgument 参数修改使用 Diagnostic 开关返回的结果。 通常情况下,仅在应 Microsoft 客户服务和支持部门请求排查问题时,才使用 Diagnostic 开关和 DiagnosticArgument 参数。

参数属性

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

参数集

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

-DiagnosticInfo

适用:Exchange Online

此参数仅在基于云的服务中可用。

通常,仅在Microsoft Customer Service 和 Support 的请求下使用 DiagnosticInfo 参数来解决问题。 有效值包含:

  • attachmentid=String
  • batch=String
  • 确认
  • duration=String
  • endpoints
  • endtime=DateTime
  • maxsize=Int32
  • organization=String
  • partition=String
  • reportid=String
  • 报告
  • showtimeline
  • showtimeslots=String
  • starttime=DateTime
  • status=String
  • storage
  • type=String
  • user=String
  • 详细

参数属性

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

参数集

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

-DomainController

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

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

参数属性

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

参数集

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

-Identity

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Identity 参数指定要检索其设置的迁移终结点的名称。

参数属性

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

参数集

Identity
Position:1
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Partition

适用:Exchange Online

此参数仅在基于云的服务中可用。

保留此参数以供 Microsoft 内部使用。

参数属性

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

参数集

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

-Type

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Type 参数按迁移类型筛选结果。 PasswordQuality 参数指定设备密码所需的最小密码质量分级。密码质量是指示密码安全性和复杂性的数值。质量值越高表示密码越安全。

  • ExchangeOutlookAnywhere:直接转换或暂存 Exchange 迁移
  • ExchangeRemoteMove:远程移动和迁移
  • IMAP:IMAP 迁移
  • PublicFolder:公用文件夹迁移

参数属性

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

参数集

TypeFilter
Position:Named
必需:True
来自管道的值: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 不返回任何数据。