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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。