Set-MigrationEndpoint
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 Set-MigrationEndpoint Cmdlet 來編輯轉換或暫存 Exchange 移轉、IMAP 移轉、Google Workspace (先前的 G Suite) 移轉，以及遠端移動的設定。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
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>] Description
使用 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 或參數所需的權限，請參閱 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
此參數只能在雲端式服務中使用。
{{ 填入 AcceptUntrustedCertificates 描述 }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ApplicationId
此參數只能在雲端式服務中使用。
{{ 填滿 ApplicationId 描述 }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AppSecretKeyVaultUrl
此參數只能在雲端式服務中使用。
{{ 填入 AppSecretKeyVaultUrl 描述 }}
| 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 移轉。
指定的帳號必須具有下列許可權：
- FullAccess 許可權。 帳戶具有他們想要移轉之信箱Full-Access許可權。
- 管理員許可權。 帳戶是網域系統管理員，可以存取他們想要移轉的任何信箱。
| 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 參數會指定遠端名稱服務提供者介面的 FQDN (NSPI) 伺服器。 此參數僅適用于未使用自動探索的暫存和完全轉移 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 Proxy 伺服器的 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 參數會指定遠端郵件伺服器所使用的加密方法。 選項為 None、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
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。