Get-MigrationEndpoint
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 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>]
Description
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 或參數所需的權限,請參閱 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 客戶服務和支援人員的要求時,才使用 DiagnosticInfo 參數來疑難排解問題。 有效值為:
- attachmentid=String
- batch=String
- 確認
- duration=字串
- 端點
- endtime=DateTime
- maxsize=Int32
- organization=String
- partition=String
- reportid=字串
- 報告
- showTimeline
- showtimeslots=字串
- starttime=DateTime
- status=String
- 儲存空間
- 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 參數會指定您要擷取設定之遷移端點的名稱。
警告: Identity 參數的值 $null 或不存在的值會傳回 所有 物件,就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤,且不包含不存在的$null值。
參數屬性
| 類型: | 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 參數會根據移轉類型來篩選結果。 此參數的有效值為:
- 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
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。