New-MigrationEndpoint

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または別の環境に限定される場合があります。

New-MigrationEndpoint コマンドレットを使用して、フォレスト間の移動、リモート移動の移行、一括または段階的な Exchange の移行、IMAP の移行、および Google Workspace (旧称 G Suite) の移行の接続設定を構成します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

ExchangeRemoteMoveAutoDiscover

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-WhatIf]
    [<CommonParameters>]

ExchangeOutlookAnywhereAutoDiscover

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeOutlookAnywhere

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    [-EmailAddress <SmtpAddress>]
    [-ExchangeOutlookAnywhere]
    [-ExchangeServer <String>]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-NspiServer <String>]
    [-Partition <MailboxIdParameter>]
    [-RpcProxyServer <Fqdn>]
    [-SkipVerification]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeRemoteMove

New-MigrationEndpoint
    -Name <String>
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-ExchangeRemoteMove]
    [-ApplicationId <String>]
    [-AppSecretKeyVaultUrl <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-RemoteTenant <String>]
    [-SkipVerification]
    [-WhatIf]
    [<CommonParameters>]

PSTImport

New-MigrationEndpoint
    -Name <String>
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-PSTImport]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-WhatIf]
    [<CommonParameters>]

IMAP

New-MigrationEndpoint
    -Name <String>
    -RemoteServer <Fqdn>
    [-IMAP]
    [-Port <Int32>]
    [-Security <IMAPSecurityMechanism>]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-WhatIf]
    [<CommonParameters>]

Gmail

New-MigrationEndpoint
    -Name <String>
    -ServiceAccountKeyFileData <Byte[]>
    [-Gmail]
    [-EmailAddress <SmtpAddress>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-WhatIf]
    [<CommonParameters>]

GoogleMarketplaceApp

New-MigrationEndpoint
    -Name <String>
    -OAuthCode <SecureString>
    [-Gmail]
    [-Confirm]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-ProgressAction <ActionPreference>]
    [-RedirectUri <String>]
    [-SkipVerification]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

PublicFolder

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RpcProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolder]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Compliance

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-Compliance]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-WhatIf]
    [<CommonParameters>]

MrsProxyPublicFolderToUnifiedGroup

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolderToUnifiedGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

MrsProxyPublicFolder

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolder]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-WhatIf]
    [<CommonParameters>]

LegacyPublicFolderToUnifiedGroup

New-MigrationEndpoint
    -Name <String>
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RpcProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolderToUnifiedGroup]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [-SkipVerification]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

説明

New-MigrationEndpoint コマンドレットは、さまざまな種類の移行に関する接続設定を構成します。

  • フォレスト間の移動: 2 つの異なるオンプレミスの Exchange フォレスト間でメールボックスを移動します。 フォレスト間の移動には、リモート移動エンドポイントを使用する必要があります。
  • リモート移動の移行: ハイブリッド展開では、リモート移動の移行には、オンボードまたはオフボード移行が含まれます。 リモート移動の移行では、Exchange のリモート移動エンドポイントも使用する必要があります。 オンボードでは、オンプレミスの Exchange organization から Exchange Online にメールボックスが移動され、移行バッチのソース エンドポイントとしてリモート移動エンドポイントが使用されます。 オフボードでは、メールボックスが Exchange Online からオンプレミスの Exchange organization に移動し、移行バッチのターゲット エンドポイントとしてリモート移動エンドポイントが使用されます。
  • 一括 Exchange 移行: オンプレミスの Exchange organization 内のすべてのメールボックスを Exchange Online に移行します。 一括 Exchange 移行では、Outlook Anywhere 移行エンドポイントを使用する必要があります。
  • 段階的な Exchange の移行: メールボックスのサブセットをオンプレミスの Exchange organization から Exchange Online に移行します。 段階的な Exchange 移行では、Outlook Anywhere 移行エンドポイントを使用する必要があります。
  • IMAP の移行: オンプレミスの Exchange organization またはその他の電子メール システムから Exchange Online にメールボックス データを移行します。 IMAP 移行の場合は、メールボックス データを移行する前に、最初にクラウドベースのメールボックスを作成する必要があります。 IMAP 移行では、IMAP エンドポイントを使用する必要があります。
  • Google Workspace の移行: メールボックス データを Google Workspace テナントから Exchange Online に移行します。 Google Workspace に移行する場合は、メールボックス データを移行する前に、まずクラウドベースのメール ユーザーまたはメールボックスを作成する必要があります。 Google Workspace を移行するには、Gmail エンドポイントを使用する必要があります。

単一のオンプレミス Exchange フォレスト内の異なるサーバーまたはデータベース間でメールボックスを移動する場合 (ローカル移動と呼ばれます)、移行エンドポイントは必要ありません。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例 1

New-MigrationEndpoint -Name Endpoint1 -ExchangeRemoteMove -Autodiscover -EmailAddress tonysmith@contoso.com -Credentials (Get-Credential contoso\tonysmith)

この例では、Autodiscover パラメーターを使用して設定を検出し、リモート移動用のエンドポイントを作成します。

例 2

New-MigrationEndpoint -Name Endpoint2 -ExchangeRemoteMove -RemoteServer MRSServer.contoso.com -Credentials (Get-Credential Contoso.com\Administrator)

この例では、設定を手動で指定し、リモートの移動用にエンドポイントを作成します。

例 3

$Credentials = Get-Credential

New-MigrationEndpoint -ExchangeOutlookAnywhere -Name EXCH-AutoDiscover -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

この例では、オンプレミスの組織への接続設定を検出するために Autodiscover パラメーターを使用して Outlook organization 移行エンドポイントを作成します。 Outlook Anywhere エンドポイントは、一括移行と段階的な Exchange 移行に使用されます。 Get-Credential コマンドレットは、ドメイン内で必要な管理者特権を持ち、移行されたメールボックスにアクセスできるオンプレミス アカウントの資格情報を取得するために使用されます。 ユーザー名の入力を求められたら、管理者アカウントの電子メール アドレスまたは domain\username 形式のいずれかを使用できます。 このアカウントは、EmailAddress パラメーターで指定されたものと同じにすることができます。

例 4

New-MigrationEndpoint -ExchangeOutlookAnywhere -Name EXCH_Manual -ExchangeServer EXCH-01-MBX.contoso.com -RPCProxyServer EXCH-02-CAS.contoso.com -Credentials (Get-Credential administrator@contoso.com) -EmailAddress annb@contoso.com

この例では、接続設定を手動で指定して、Outlook Anywhere 移行エンドポイントを作成します。 Outlook Anywhere エンドポイントは、一括移行と段階的な Exchange 移行に使用されます。 ExchangeServer パラメーターの値は、移行されたメールボックスをホストするオンプレミスの Exchange サーバーを指定します。 RPCProxyServer パラメーターの値は、クライアント接続を直接受け入れてプロキシするクライアント アクセス サーバーの役割がインストールされているオンプレミス組織内の organization 内の Exchange サーバーを指定します。 EmailAddress パラメーターには、社内ドメイン内の任意のメールボックスを指定できます。

移行バッチ内の各ユーザー メールボックスへの接続には自動検出サービスが使用されるため、自動的に検出される接続設定 (例 3 を参照) で作成された移行エンドポイントを使用することをお勧めします。 エンドポイントの接続設定を手動で指定し、ユーザー メールボックスが ExchangeServer パラメーターで指定されたサーバーに存在しない場合、そのユーザーの移行は失敗します。 これは、複数のオンプレミスの Outlook Anywhere サーバーがある場合に重要です。 それ以外の場合は、各オンプレミス サーバーに対応する異なる移行エンドポイントを作成する必要がある場合があります。

例 5

New-MigrationEndpoint -IMAP -Name IMAP_TLS_Endpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations 50 -MaxConcurrentIncrementalSyncs 10

また、50 個の同時移行と 10 個の同時増分同期をサポートする IMAP 移行エンドポイントを作成します。 エンドポイントは、TLS 暗号化にポート 143 を使用するように構成されます。

パラメーター

-AcceptUntrustedCertificates

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Online

AcceptUntrustedCertificates スイッチは、リモート サーバーからの信頼されていない証明書を受け入れるかどうかを指定します。 このスイッチで値を指定する必要はありません。

セキュリティ リスクが生じる可能性があるため、運用環境ではこのスイッチを使用しないことをお勧めします。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhere
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
IMAP
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ApplicationId

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

ApplicationId パラメーターは、リモート移動の移行のクロステナント認証を定義するために使用されるアプリのアプリケーション ID を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMove
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AppSecretKeyVaultUrl

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

AppSecretKeyVaultUrl パラメータは、リモート移動の移行でクロステナント認証に使用されるアプリケーション シークレットを指すAzure Key Vault URL を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMove
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Authentication

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

Authentication パラメーターには、社内のメール サーバーによって使用される認証方法を指定します。 このパラメーターを含めない場合、Basic 認証が使用されます。

パラメーターのプロパティ

型:AuthenticationMethod
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeOutlookAnywhere
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
IMAP
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PublicFolder
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Autodiscover

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

自動検出スイッチは、Exchange 移行のために自動検出サービスからオンプレミス サーバーの他の接続設定を取得するかどうかを指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMoveAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Compliance

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

コンプライアンス スイッチは、エンドポイントの種類をコンプライアンスに指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Compliance
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Credentials

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Credentials パラメーターは、すべての Exchange 移行の種類について、ソースまたはターゲットのエンドポイントに接続するための資格情報を指定します。

このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。

パラメーターのプロパティ

型:PSCredential
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMoveAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhere
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Compliance
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DomainController

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMoveAutoDiscover
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhere
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeRemoteMove
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PSTImport
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
IMAP
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Gmail
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PublicFolder
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Compliance
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolderToUnifiedGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolder
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EmailAddress

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

EmailAddress パラメーターは、自動検出サービスで使用される電子メール アドレス、または、場合によって手動で接続設定が指定されたときにエンドポイントを検証するために使用される電子メール アドレスを指定します。

パラメーターのプロパティ

型:SmtpAddress
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMoveAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExchangeOutlookAnywhere

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

ExchangeOutlookAnywhere スイッチは、段階的移行および一括移行のエンドポイントの種類を指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhere
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExchangeRemoteMove

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

ExchangeRemoteMove スイッチは、ハイブリッド展開でのフォレスト間移動とリモート移動移行のエンドポイントの種類を指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMoveAutoDiscover
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeRemoteMove
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExchangeServer

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

ExchangeServer パラメーターは、移行されたメールボックスをホストするオンプレミスの Exchange サーバーの FQDN を指定します。 このパラメータは、一括移行および段階的な Exchange 移行用の Outlook Anywhere 移行エンドポイントを作成するときに使用されます。

このパラメーターは、Autodiscover パラメーターを使用しない場合にのみ必要です。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeOutlookAnywhere
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Gmail

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

Gmail スイッチは、Google Workspace 移行のエンドポイントの種類を指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Gmail
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
GoogleMarketplaceApp
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IMAP

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

IMAP スイッチは、IMAP 移行のエンドポイントの種類を指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

IMAP
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MailboxPermission

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

MailboxPermission パラメーターは、Outlook Anywhere オンボード (段階的な Exchange 移行およびカットオーバー Exchange 移行) 中にソース メールボックスにアクセスするために使用するアクセス許可を指定します。

エンドポイントに対して指定された移行管理者アカウントには、次のアクセス許可のいずれかが必要です。

  • Admin: このアカウントは、移行するすべてのメールボックスにアクセスできるドメイン管理者です。
  • FullAccess: アカウントには、移行するメールボックスへのフル アクセス許可、または移行されたメールボックスをホストするメールボックス データベースに対する受信者アクセス許可のいずれかが割り当てられます。

このパラメーターが指定されていない場合、コマンドレットでは、ドメイン管理者のアクセス許可を使用してソース メールボックスにアクセスしようとします。これが失敗した場合、フル アクセス許可または受信者アクセス許可を使用してソース メールボックスにアクセスしようとします。

このパラメーターは、Outlook 以外の Anywhere 移行エンドポイントの作成には使用できません。

パラメーターのプロパティ

型:MigrationMailboxPermission
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhere
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MaxConcurrentIncrementalSyncs

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

MaxConcurrentIncrementalSyncs パラメーターは、エンドポイントごとに許容される増分同期の最大数を指定します。 既定値は 20 です。

パラメーターのプロパティ

型:Unlimited
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MaxConcurrentMigrations

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

MaxConcurrentMigrations パラメーターは、初期同期中に移行されるメールボックスの最大数を指定します。このパラメーターは、すべての移行の種類に適用されます。 既定値は 100 です。

パラメーターのプロパティ

型:Unlimited
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Name パラメーターは、新しい移行エンドポイントに付ける名前を指定します。 New-MigrationBatch コマンドレットを実行する場合は、Name パラメーターが使用できます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NspiServer

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

NspiServer パラメーターは、カットオーバー移行および段階的移行のリモート NSPI (Name Service Provider Interface) サーバーの場所を指定します。 サーバーの FQDN を指定する必要があります。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeOutlookAnywhere
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OAuthCode

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

OAuthCode パラメーターは、Google Marketplace アプリを使用して Google Workspace 移行エンドポイントを作成するために Google から取得した OAuth 認証コードを指定します。

パラメーターのプロパティ

型:SecureString
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

GoogleMarketplaceApp
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Partition

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:MailboxIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Port

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

Port パラメーターは、IMAP 移行サービスがリモート サーバーに接続するために使用する TCP ポート番号を指定します。 既定値は 993 です。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

IMAP
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PSTImport

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PSTImport
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PublicFolder

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PublicFolderDatabaseServerLegacyDN

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PublicFolderToUnifiedGroup

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

PublicFolderToUnifiedGroup スイッチは、エンドポイントの種類が Microsoft 365 グループへのパブリック フォルダーであることを指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

MrsProxyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RedirectUri

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

RedirectUri パラメーターは、Google Workspace 移行エンドポイントの作成時に OAuth 認証中に使用される Google Marketplace アプリに登録されたリダイレクト URI を指定します。 リダイレクト URI は Google Marketplace アプリに登録されているものと完全に一致する必要があります。一致しない場合、OAuth 認証は失敗します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

GoogleMarketplaceApp
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RemoteServer

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

RemoteServer パラメーターは、移動のプロトコル タイプに応じたリモート サーバーの FQDN を指定します。

  • フォレスト間の移動とリモート移動の移行の場合、このパラメーターは、クライアント接続を直接受け入れてプロキシするクライアント アクセス サーバーの役割がインストールされているオンプレミス組織の organization 内の Exchange サーバーを参照します。
  • IMAP 移行の場合は、このパラメーターが IMAP サーバーを参照します。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMove
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PSTImport
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
IMAP
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Compliance
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RemoteTenant

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

RemoteTenant パラメーターは、テナント間メールボックスの移動の移行用のリモート テナント ドメインを指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeRemoteMove
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RpcProxyServer

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

RpcProxyServer パラメータは、クライアント接続を直接受け入れてプロキシするクライアント アクセス サーバーの役割をインストールしているオンプレミスの Exchange organization 内の Exchange サーバーの FQDN を指定します。 このパラメータは、一括移行および段階的な Exchange 移行用の Outlook Anywhere 移行エンドポイントを作成するときに使用されます。 通常、この FQDN は Outlook on the web の URL と同じです。 たとえば、「mail.contoso.com」と入力します。 Outlook が Exchange サーバーへの接続に使用するプロキシ サーバーの URL でもあります。

このパラメーターは、Autodiscover パラメーターを使用しない場合にのみ必要です。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhere
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Security

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

セキュリティ パラメーターは、IMAP 移行にリモート メール サーバーが使用する暗号化方法を指定します。 有効な値は次のとおりです。

  • なし
  • SSLにする
  • TLS

パラメーターのプロパティ

型:IMAPSecurityMechanism
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

IMAP
配置: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
DontShow:False

パラメーター セット

Gmail
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SkipVerification

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

SkipVerification スイッチは、移行エンドポイントの作成中にリモート サーバーに到達できるかの検証をスキップするかどうかを指定します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SourceMailboxLegacyDN

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

SourceMailboxLegacyDN パラメーターは、移行サービスが、このエンドポイントを使用して接続を作成できるかどうかをテストするために使用されるオンプレミスのメールボックスの LegacyExchangeDN 値を指定します。 コマンドレットは、コマンドで指定された管理者アカウントの資格情報を使用してこのメールボックスへのアクセスを試みます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PublicFolder
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TestMailbox

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

TestMailbox パラメーターは、このエンドポイントを使用して接続を確認するために移行サービスによってターゲットとして使用される Exchange Online メールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)

このパラメーターを使用しない場合、移行サービスはExchange Online organization内の移行調停メールボックスを使用して接続を確認します。

パラメーターのプロパティ

型:MailboxIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ExchangeOutlookAnywhereAutoDiscover
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ExchangeOutlookAnywhere
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Gmail
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
GoogleMarketplaceApp
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PublicFolder
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
MrsProxyPublicFolderToUnifiedGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
LegacyPublicFolderToUnifiedGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。