Set-MigrationEndpoint
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Set-MigrationEndpoint Cmdlet 編輯完全移轉或分段 Exchange 移轉、IMAP 移轉、Google Workspace (先前為 G Suite) 移轉和遠端移轉的設定。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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 Workspace 租用戶移轉至 Exchange Online。 如果是移轉 Google Workspace，您必須先建立雲端式郵件使用者或信箱，然後才能移轉信箱資料。 Google Workspace 移轉作業需要使用 Gmail 端點。
- 本機： 在單一內部部署 Exchange 樹系內的不同伺服器或資料庫之間移動信箱。 本機移動不需要使用端點。
如需不同移動和移轉案例的詳細資訊，請參閱：
對端點所做的變更若會影響批次中的個別使用者，將從下次處理批次時開始套用。 如果您在雲端式服務中執行這個 Cmdlet，而且想要加速這些設定的套用，請考慮使用 -Update 參數執行 Set-MigrationBatch 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
適用：Exchange Online
此參數只能在雲端式服務中使用。
AcceptUntrustedCertificates 參數會指定是否接受來自遠端伺服器的不受信任憑證。 有效的值為 $true 或 $false。 此參數適用於 ExchangeOutlookAnywhere 和 IMAP 移轉端點。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ApplicationId
適用：Exchange Online
此參數只能在雲端式服務中使用。
ApplicationId 參數會指定在 Microsoft Entra ID 中註冊的應用程式應用程式識別碼，用於 ExchangeRemoteMove 移轉端點中的跨租用戶驗證。 請將此參數與 AppSecretKeyVaultUrl 搭配使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AppSecretKeyVaultUrl
適用：Exchange Online
此參數只能在雲端式服務中使用。
AppSecretKeyVaultUrl 參數會指定Azure 金鑰保存庫 URL，其中包含用於 ExchangeRemoteMove 移轉端點中跨租用戶驗證的應用程式密碼。 請將此參數與 ApplicationId 搭配使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Authentication
適用：Exchange Online
此參數只能在雲端式服務中使用。
Authentication 參數會指定遠端郵件伺服器所使用的驗證方法。
參數屬性
| 類型: | AuthenticationMethod |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credentials
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Credentials 參數會指定用於連線到遠端端點的使用者名稱和密碼。 修改暫存或直接移轉 Exchange 端點或 RemoteMove 端點時，應該使用認證。
此參數的值需要使用 Get-Credential Cmdlet。 若要暫停此命令並收到輸入認證的提示，請使用值 (Get-Credential)。 或者，在您執行此命令之前，將認證儲存在變數中 (例如，$cred = Get-Credential)，然後將變數名稱 ($cred) 用於此參數。 如需詳細資訊，請參閱 Get-Credential。
參數屬性
| 類型: | PSCredential |
| 預設值: | 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 |
-ExchangeServer
適用：Exchange Online
此參數只能在雲端式服務中使用。
ExchangeServer 參數會指定內部部署來源 Exchange 伺服器，以進行完全移轉和分段移轉。 此參數僅適用於不使用自動探索的暫存和完全移轉 Exchange 端點。
參數屬性
| 類型: | String |
| 預設值: | 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 |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-MailboxPermission
適用：Exchange Online
此參數只能在雲端式服務中使用。
MailboxPermission 參數指定在 OutlookAnywhere 上線 (分段 Exchange 移轉和完全移轉 Exchange 移轉) 期間，應使用哪些權限來存取來源信箱。 此參數不適用於非 OutlookAnywhere 移轉。
指定的帳戶必須具備下列權限：
- FullAccess 權限。 該帳戶擁有想要移轉之信箱的 Full-Access 權限。
- 管理員權限。 帳戶是網域系統管理員，可以存取所要移轉的任何信箱。
參數屬性
| 類型: | MigrationMailboxPermission |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaxConcurrentIncrementalSyncs
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MaxConcurrentIncrementalSyncs 參數會指定此端點在指定時間允許的增量同步處理數量上限。 此值必須小於或等於 MaxConcurrentMigrations 參數。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaxConcurrentMigrations
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MaxConcurrentMigrations 參數會指定此端點在指定時間的移轉信箱數目上限。 此參數適用於所有遷移類型。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NspiServer
適用：Exchange Online
此參數只能在雲端式服務中使用。
NspiServer 參數會指定 NSPI) 伺服器 (遠端名稱服務提供者介面的 FQDN。 此參數僅適用於不使用自動探索的暫存和完全移轉 Exchange 端點。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Partition
適用：Exchange Online
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Port
適用：Exchange Online
此參數只能在雲端式服務中使用。
進行 IMAP 遷移時，Port 參數會指定遷移程序用來連線到遠端伺服器的 TCP 通訊埠號碼。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PublicFolderDatabaseServerLegacyDN
適用：Exchange Online
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoteServer
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
RemoteServer 參數會根據移動的通訊協定類型指定遠端伺服器：
- Exchange 伺服器移動： 具有安裝用戶端存取角色的 Exchange 伺服器的 FQDN、用戶端存取伺服器陣列，或位於支援的網路負載平衡器後方的一組用戶端存取伺服器。
- IMAP 移動：IMAP 伺服器的 FQDN。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RpcProxyServer
適用：Exchange Online
此參數只能在雲端式服務中使用。
針對分段和直接移轉 Exchange 移轉，RpcProxyServer 參數會指定內部部署 Exchange 伺服器之 RPC Proxy 伺服器的 FQDN。 此參數僅適用於不使用自動探索的暫存和完全移轉 Exchange 端點
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Security
適用：Exchange Online
此參數只能在雲端式服務中使用。
針對 IMAP 移轉，Security 參數會指定遠端郵件伺服器所使用的加密方法。 選項為 None、tls 或 ssl。
參數屬性
| 類型: | IMAPSecurityMechanism |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ServiceAccountKeyFileData
適用：Exchange Online
此參數只能在雲端式服務中使用。
ServiceAccountKeyFileData 參數可用來指定以服務帳戶身分驗證所需的資訊。 資料應來自 JSON 金鑰檔案，該檔案是在建立授與遠端租用戶存取權的服務帳戶時下載。
若要使用此參數的有效值，您必須使用下列語法將檔案讀取至位元組編碼物件： ([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 |
-SkipVerification
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SkipVerification 參數會在修改移轉端點時跳過驗證遠端伺服器是否可連線。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SourceMailboxLegacyDN
適用：Exchange Online
此參數只能在雲端式服務中使用。
SourceMailboxLegacyDN 參數會指定目標伺服器上的信箱。 使用內部部署測試信箱的 LegacyExchangeDN 作為此參數的值。 Cmdlet 嘗試使用目標伺服器上系統管理員帳戶的認證來存取此信箱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TestMailbox
適用：Exchange Online
此參數只能在雲端式服務中使用。
TestMailbox 參數會指定目標伺服器上的信箱。 使用主要 SMTP 位址做為此參數的值。 Cmdlet 嘗試使用目標伺服器上系統管理員帳戶的認證來存取此信箱。
參數屬性
| 類型: | MailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(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
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。