Set-MigrationEndpoint
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Set-MigrationEndpoint cmdlet 可编辑直接转换或暂存 Exchange 迁移、IMAP 迁移、Google Workspace (以前的 G Suite) 迁移和远程移动的设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-MigrationEndpoint
[-Identity] <MigrationEndpointIdParameter>
[-AcceptUntrustedCertificates <Boolean>]
[-ApplicationId <String>]
[-AppSecretKeyVaultUrl <String>]
[-Authentication <AuthenticationMethod>]
[-Confirm]
[-Credentials <PSCredential>]
[-DomainController <Fqdn>]
[-ExchangeServer <String>]
[-MailboxPermission <MigrationMailboxPermission>]
[-MaxConcurrentIncrementalSyncs <Unlimited>]
[-MaxConcurrentMigrations <Unlimited>]
[-NspiServer <String>]
[-Partition <MailboxIdParameter>]
[-Port <Int32>]
[-PublicFolderDatabaseServerLegacyDN <String>]
[-RemoteServer <Fqdn>]
[-RpcProxyServer <Fqdn>]
[-Security <IMAPSecurityMechanism>]
[-ServiceAccountKeyFileData <Byte[]>]
[-SkipVerification]
[-SourceMailboxLegacyDN <String>]
[-TestMailbox <MailboxIdParameter>]
[-WhatIf]
[<CommonParameters>] 说明
使用 Set-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 终结点。
- Gmail 迁移：将邮箱数据从 Google 工作区租户迁移到Exchange Online。 对于 Google 工作区迁移，必须先创建基于云的邮件用户或邮箱，然后迁移邮箱数据。 Google 工作区迁移需要使用 Gmail 终结点。
- 本地：在单个本地 Exchange 林中的不同服务器或数据库之间移动邮箱。 本地移动不需要使用终结点。
有关不同的移动和迁移方案的详细信息，请参阅：
对终结点所做的更改会影响批处理中的单个用户，从下一次处理批处理时开始应用。 如果在基于云的服务中运行此 cmdlet 并希望加快这些设置的应用速度，请考虑使用 -Update 参数运行 Set-MigrationBatch cmdlet。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.com此示例在使用 NSPI 服务器 Server01 的 CutoverExchangeEndpoint01 迁移终结点上将 MaxConcurrentIncrementalSyncs 设置更改为 50。
示例 2
Set-MigrationEndpoint -Identity Onboardingmigrationendpoint01 -MaxConcurrentMigrations 10 -RemoteServer Server01.contoso.com此示例在使用远程服务器 Server01 的 Onboardingmigrationendpoint01 迁移终结点上将 MaxConcurrentMigrations 设置更改为 10。
参数
-AcceptUntrustedCertificates
此参数仅在基于云的服务中可用。
{{ Fill AcceptUntrustedCertificates Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ApplicationId
此参数仅在基于云的服务中可用。
{{ Fill ApplicationId Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AppSecretKeyVaultUrl
此参数仅在基于云的服务中可用。
{{ Fill AppSecretKeyVaultUrl Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Authentication
此参数仅在基于云的服务中可用。
Authentication 参数指定远程邮件服务器使用的身份验证方法。
| Type: | AuthenticationMethod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Credentials
Credentials 参数指定用于连接到远程终结点的用户名和密码。 创建暂存或直接转换 Exchange 终结点或 RemoteMove 终结点时，应使用凭据。
此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示，请使用值 (Get-Credential)。 或者，在运行此命令之前，请将凭据存储在变量（例如，$cred = Get-Credential）中，然后将变量名称 ($cred) 用作此参数。 有关详细信息，请参阅 Get-Credential。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExchangeServer
此参数仅在基于云的服务中可用。
ExchangeServer 参数指定用于直接转换和暂存迁移的本地源 Exchange 服务器。 此参数仅适用于不使用自动发现的暂存和直接转换 Exchange 终结点。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Identity 参数指定要配置的迁移终结点的名称。
| Type: | MigrationEndpointIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MailboxPermission
此参数仅在基于云的服务中可用。
MailboxPermission 参数指定在 OutlookAnywhere 加入期间（暂存 Exchange 迁移和直接转换 Exchange 迁移）应当用来访问源邮箱的权限。 此参数不可用于非 OutlookAnywhere 迁移。
指定帐户必须拥有以下权限：
- 完全访问权限。 帐户拥有对要迁移的邮箱的完全访问权限。
- 管理权限。 帐户是域管理员，可以访问任何要迁移的邮箱。
| Type: | MigrationMailboxPermission |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MaxConcurrentIncrementalSyncs
MaxConcurrentIncrementalSyncs 参数指定在指定时间此终结点允许的最大增量同步数。 此值必须小于或等于 MaxConcurrentMigrations 参数。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MaxConcurrentMigrations
MaxConcurrentMigrations 参数指定在指定时间为此终结点迁移的最大邮箱数。 此参数适用于所有迁移类型。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-NspiServer
此参数仅在基于云的服务中可用。
NspiServer 参数指定远程名称服务提供程序接口 (NSPI) 服务器的 FQDN。 此参数仅适用于不使用自动发现的暂存和直接转换 Exchange 终结点。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Partition
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Port
此参数仅在基于云的服务中可用。
对于 IMAP 迁移，Port 参数指定迁移过程用来连接到远程服务器的 TCP 端口号。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PublicFolderDatabaseServerLegacyDN
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteServer
RemoteServer 参数根据移动的协议类型指定远程服务器：
- Exchange 服务器移动：安装了客户端访问角色的 Exchange 服务器的 FQDN、客户端访问服务器阵列或位于受支持的网络负载均衡器后面的一组客户端访问服务器。
- IMAP 移动：IMAP 服务器的 FQDN。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RpcProxyServer
此参数仅在基于云的服务中可用。
对于分阶段 Exchange 迁移，RpcProxyServer 参数指定本地 Exchange 服务器的 RPC 代理服务器的 FQDN。 此参数仅适用于不使用自动发现的暂存和直接转换 Exchange 终结点
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Security
此参数仅在基于云的服务中可用。
对于 IMAP 迁移，Security 参数指定远程邮件服务器使用的加密方法。 选项为“无”、“Tls”或“Ssl”。
| Type: | IMAPSecurityMechanism |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ServiceAccountKeyFileData
此参数仅在基于云的服务中可用。
ServiceAccountKeyFileData 参数用于指定作为服务帐户进行身份验证所需的信息。 数据应来自在创建已授予远程租户访问权限的服务帐户时下载的 JSON 密钥文件。
此参数的有效值要求使用以下语法将文件读取到字节编码对象： ([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 Online |
-SkipVerification
在创建迁移终结点时，SkipVerification 开关将跳过验证远程服务器是否可访问的操作。 不必为此开关指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceMailboxLegacyDN
此参数仅在基于云的服务中可用。
SourceMailboxLegacyDN 参数指定目标服务器上的一个邮箱。 使用内部部署测试邮箱的 LegacyExchangeDN 作为此参数的值。 该 cmdlet 将尝试使用目标服务器上管理员帐户的凭据访问此邮箱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-TestMailbox
此参数仅在基于云的服务中可用。
TestMailbox 参数指定目标服务器上的一个邮箱。 使用主 SMTP 地址作为此参数的值。 该 cmdlet 将尝试使用目标服务器上管理员帐户的凭据访问此邮箱。
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。