Test-MigrationServerAvailability

構文

ExchangeRemoteMoveAutodiscover

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeOutlookAnywhereAutodiscover

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Confirm]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-Partition <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

PSTImport

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-FilePath <String>]
    [-PSTImport]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeOutlookAnywhere

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -ExchangeServer <String>
    -RPCProxyServer <Fqdn>
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-EmailAddress <SmtpAddress>]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-TestMailbox <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

PublicFolder

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolder]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeRemoteMove

Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

TestEndpoint

Test-MigrationServerAvailability
    -Endpoint <MigrationEndpointIdParameter>
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

IMAP

Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    -Port <Int32>
    [-Imap]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Security <<NIMAPSecurityMechanism]>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Gmail

Test-MigrationServerAvailability
    -ServiceAccountKeyFileData <Byte[]>
    [-Gmail]
    [-EmailAddress <SmtpAddress>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Compliance

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Compliance]
    [-RemoteServer <Fqdn>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

MrsProxyPublicFolderToUnifiedGroup

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolderToUnifiedGroup]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

LegacyPublicFolderToUnifiedGroup

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolderToUnifiedGroup]
    [-Authentication <AuthenticationMethod>]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

MrsProxyPublicFolder

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolder]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

説明

例

例 1

Test-MigrationServerAvailability -Imap -RemoteServer imap.contoso.com -Port 143

例 2

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

例 3

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -ExchangeServer exch2k3.contoso.com -Credentials $Credentials -RPCProxyServer mail.contoso.com -Authentication NTLM

例 4

Test-MigrationServerAvailability -Endpoint endpoint.contoso.com

例 5

$MRSEndpoints = (Get-MigrationEndpoint).Identity

Foreach ($MEP in $MRSEndpoints) {Test-MigrationServerAvailability -Endpoint $MEP}

パラメーター

-AcceptUntrustedCertificates

適用対象: Exchange Online

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

{{ Fill AcceptUntrustedCertificates Description }}

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

パラメーター セット

-Authentication

適用対象: Exchange Online

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

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

パラメーターは、Exchange の一括移行と段階的な Exchange 移行にのみ使用されます。

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

パラメーター セット

-Autodiscover

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

自動検出スイッチは、コマンドが自動検出サービスを使用してターゲット サーバーの接続設定を取得するように指定します。 このスイッチで値を指定する必要はありません。

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

パラメーター セット

-Compliance

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

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

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

パラメーター セット

-Confirm

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

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

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

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

パラメーター セット

-Credentials

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

Credentials パラメーターは、ターゲット サーバー上のメールボックスにアクセスできるアカウントのユーザー名とパスワードを指定します。 domain\username 形式またはユーザー プリンシパル名 (UPN) 形式 (たとえば、 user@contoso.com) でユーザー名を指定します。

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

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

パラメーター セット

-EmailAddress

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

EmailAddress パラメーターは、リモート サーバーにアクセスできる管理者アカウントの電子メール アドレスを指定します。 このパラメーターは、Autodiscover パラメーターを使用する場合に必要です。

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

パラメーター セット

-Endpoint

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

Endpoint パラメーターは、接続する移行エンドポイントの名前を指定します。 移行エンドポイントには、接続設定およびその他の移行構成の設定が含まれます。 このパラメーターを含めると、Test-MigrationServerAvailability コマンドレットは、移行エンドポイント内の設定を使用してリモート サーバーへの接続機能の確認を試みます。

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

パラメーター セット

-ExchangeOutlookAnywhere

適用対象: Exchange Online

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

ExchangeOutlookAnywhere スイッチは、オンプレミスメールボックスをExchange Onlineに移行するための移行の種類を指定します。 このスイッチで値を指定する必要はありません。

段階的な Exchange 移行または一括 Exchange 移行を使用してメールボックスをExchange Onlineに移行する場合は、このスイッチを使用します。

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

パラメーター セット

-ExchangeRemoteMove

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

ExchangeRemoteMove スイッチは、2 つのオンプレミスフォレスト間、またはオンプレミスフォレストとExchange Online間で完全に忠実にメールボックスを移動する移行の種類を指定します。 このスイッチで値を指定する必要はありません。

このスイッチは、クロスフォレスト移動を実行するか、ハイブリッド展開でオンプレミスの Exchange organizationとExchange Online間でメールボックスを移行する場合に使用します。

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

パラメーター セット

-ExchangeServer

適用対象: Exchange Online

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

ExchangeServer パラメーターは、オンプレミスの Exchange サーバーの FQDN を指定します。 段階的な Exchange 移行または一括 Exchange 移行を実行する予定の場合は、このパラメーターを使用します。 このパラメーターは、Autodiscover パラメーターを使用しない場合に必要です。

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

パラメーター セット

-FilePath

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

FilePath パラメーターは、PST インポート移行エンドポイントをテストするときに PST ファイルを含むパスを指定します。

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

パラメーター セット

-Gmail

適用対象: Exchange Online

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

Gmail パラメーターは、移行の種類として Gmail を指定します。 このスイッチで値を指定する必要はありません。

この切り替えは、Google ワークスペース (旧称 G Suite) テナントからExchange Online メールボックスにデータを移行する場合に必要です。

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

パラメーター セット

-Imap

適用対象: Exchange Online

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

Imap パラメーターは、IMAP 移行の種類を指定します。 このスイッチで値を指定する必要はありません。

この切り替えは、IMAP メール サーバーからExchange Onlineメールボックスにデータを移行する場合に必要です。

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

パラメーター セット

-MailboxPermission

適用対象: Exchange Online

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

MailboxPermission パラメーターは、Credentials パラメーターによって定義された移行管理者アカウントに割り当てるアクセス許可を指定します。 段階的またはカットオーバー Exchange 移行の準備、または、Exchange Outlook Anywhere 移行エンドポイントの作成の準備における接続設定のテスト時に、移動元メール サーバー上のユーザー メールボックスへの接続をテストするためのアクセス許可割り当てを作成します。

Credentials パラメーターによって定義されたアカウントに、次の値のいずれかを指定します。

• FullAccess: アカウントには、移行するメールボックスに Full-Access アクセス許可が割り当てられます。
• 管理: アカウントは、移行するメールボックスをホストするorganizationの Domain Admins グループのメンバーです。

このパラメーターは、リモート移動移行または IMAP 移行用のリモート サーバーへの接続のテストには使用されません。

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

パラメーター セット

-Partition

適用対象: Exchange Online

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

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

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

パラメーター セット

-Port

適用対象: Exchange Online

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

Port パラメーターは、IMAP 移行処理でターゲット サーバーへの接続に使用される TCP ポート番号を指定します。 このパラメーターは、IMAP 移行の場合にのみ必要です。

標準では暗号化されていない接続にポート 143、トランスポート層セキュリティ (TLS) にポート 143、SSL (Secure Sockets Layer) にポート 993 を使用します。

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

パラメーター セット

-PSTImport

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

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

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

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

パラメーター セット

-PublicFolder

適用対象: Exchange Online

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

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

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

パラメーター セット

-PublicFolderDatabaseServerLegacyDN

適用対象: Exchange Online

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

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

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

パラメーター セット

-PublicFolderToUnifiedGroup

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

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

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

パラメーター セット

-RemoteServer

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

RemoteServer パラメーターは、オンプレミスのメール サーバーの完全修飾ドメイン名を指定します。 このパラメーターは、次の移行の種類のいずれかを実行する場合に必要です。

• フォレスト間移動
• リモートの移動 （ハイブリッド展開）
• IMAP 移行

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

パラメーター セット

-RPCProxyServer

適用対象: Exchange Online

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

RPCProxyServer パラメーターは、オンプレミスの Exchange サーバーの RPC プロキシ サーバーの FQDN を指定します。 このパラメーターは、Autodiscover パラメーターを使用しない場合に必要です。 段階的な Exchange 移行または一括 Exchange 移行を実行してメールボックスをExchange Onlineに移行する場合は、このパラメーターを使用します。

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

パラメーター セット

-Security

適用対象: Exchange Online

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

IMAP 移行の場合、Security パラメーターは、リモート メール サーバーで使用される暗号化方法を指定します。 オプションは None、Tls、または Ssl です。

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

パラメーター セット

-ServiceAccountKeyFileData

適用対象: Exchange Online

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

ServiceAccountKeyFileData パラメーターは、サービス アカウントとして認証するために必要な情報を指定するために使用されます。 データは、リモート テナントへのアクセスが許可されているサービス アカウントの作成時にダウンロードされる JSON キー ファイルから取得する必要があります。

このパラメーターの有効な値を使用するには、次の構文を使用して、バイトエンコードされたオブジェクトにファイルを読み取る必要があります: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))。 このコマンドをパラメーター値として使用することも、出力を変数 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) に書き込み、変数をパラメーター値 ($data) として使用することもできます。

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

パラメーター セット

-SourceMailboxLegacyDN

適用対象: Exchange Online

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

SourceMailboxLegacyDN パラメーターは、ターゲット サーバー上のメールボックスを指定します。 社内のテスト用メールボックスの場合は、このパラメーターの値として LegacyExchangeDN を使用します。 コマンドレットは、ターゲット サーバー上の管理者アカウントの資格情報を使用して、このメールボックスへのアクセスを試みます。

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

パラメーター セット

-TestMailbox

適用対象: Exchange Online

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

TestMailbox パラメーターは、ターゲット サーバー上のメールボックスを指定します。 このパラメーターの値としてプライマリ SMTP アドレスを使用します。 コマンドレットは、ターゲット サーバー上の管理者アカウントの資格情報を使用して、このメールボックスへのアクセスを試みます。

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

パラメーター セット

-WhatIf

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

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

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

パラメーター セット

CommonParameters

入力

Input types

出力

Output types