次の方法で共有


DHCP サーバーのインストールを別の Windows Server に移行する

DHCP サーバーの移行では、既存の DHCP サーバーの設定をネットワーク上の新しい DHCP サーバーに移動する必要があります。 このサーバー移行の目的は、DHCP クライアント コンピューターを変更することなく、ネットワーク上で DHCP リースを提供できるように、Windows Server オペレーティング システムに DHCP サーバーの役割をインストールすることです。

このガイドでは、Windows Server を実行しているサーバーに既存の DHCP サーバー設定を移行する手順について説明します。 このガイドを使用して DHCP サーバーを移行することで、移行を簡略化し、移行時間を短縮し、移行プロセスの精度を向上させ、DHCP 移行中に発生する可能性のある競合を排除できます。 このガイドには、移行元サーバーが複数のロールを実行している場合の移行の手順は含まれません。 サーバーが複数のロールを実行している場合は、サーバー環境に固有のカスタム移行手順を設計することをお勧めします。 移行に関するいくつかの注意事項:

  • 物理オペレーティング システムと仮想オペレーティング システム間の移行がサポートされています。
  • ソース サーバーから移行元サーバーとは異なるシステム ユーザー インターフェイス (UI) 言語でオペレーティング システムを実行している移行先サーバーへの移行はサポートされていません。
  • ハードウェアがネイティブ x64 ベースの場合でも、アップグレードの代わりに移行をお勧めします。

このガイドは、管理された環境での DHCP サーバーの運用と展開を担当する IT 管理者、IT プロフェッショナル、その他のナレッジ ワーカーを対象としています。 サーバー管理者は、移行する既存のインストールのコンポーネントを選択できます。 これらのコンポーネントには、通常、サーバーの役割と共に、構成、データ、システム ID、オペレーティング システムの設定が含まれます。

[前提条件]

  • セットアップされて実行されている既存の DHCP サーバー
  • 移行元サーバーと移行先サーバーには、次のアクセス許可が必要です。
    • DHCP サーバーを承認するために必要なドメイン管理者権限。
    • DHCP サーバーをインストールまたは管理するには、ローカル管理者権限が必要です。
    • 移行ストアの場所に対する書き込みアクセス許可が必要です。

サーバー移行プロセス

DHCP サーバーの移行は、次の主要なセクションに分かれています。

  • 移行の準備: 移行前プロセスには、データの手動収集と、移行先サーバーと移行元サーバーを準備する手順が含まれます。
  • DHCP サーバーの役割を移行する: 移行プロセスには、エクスポートとインポートのコマンドレットを使用して、サーバーの役割設定を自動的に収集、保存、移行する移行元と移行先のサーバーの手順が含まれています。
  • 移行を確認する: 移行先サーバーが移行元サーバーを正常に置き換えたかどうかを確認します。
  • 移行後のタスクを完了する: ソース サーバーを廃止するか、転用します。 失敗した場合は移行のトラブルシューティングを行い、必要に応じてロールバックします。

移行前、移行、移行後の手順を示す、サーバー移行プロセスを示す図。

移行の準備を行う

  • DHCP サーバーの送信元サーバーと移行先サーバーを特定します。

  • ソース サーバー上のドメイン、サーバー名、パスワードを決定します。 元のサーバーのドメインを識別するには、コントロール パネルからシステム設定を表示します。

  • 移行の前に、すべての重要な更新プログラムとサービス パックをソース サーバーにインストールします。 現在の重要な更新プログラムとサービス パックはすべて、移行元サーバーと移行先サーバーの両方にインストールすることをお勧めします。

  • 送信元サーバーと移行先サーバーのネットワーク アダプターの数をカウントし、それらの数が等しいことを確認します。 DHCP サーバーを実行している移行元サーバーに複数のネットワーク アダプターがあり、DHCP サーバー サービスがすべてにバインドされ、異なるサブネット上の IP アドレスを提供する場合、DHCP サーバーを実行している宛先サーバーには、ソース サーバーと同じサブネットを提供できるように、複数のネットワーク アダプターも必要です。

  • 移行ストア ファイルの場所を準備します。 ストアの場所には、エクスポート時にソース サーバーからアクセスでき、インポート時に移行先サーバーからアクセスできる必要があります。 ソース サーバーからのすべての DHCP サーバー関連情報を含めることができる共通ドライブを使用します。 ストレージの場所は、\\fileserver\users\username\ のようになります。

移行ツールのインストール

まだインストールしていない場合は、移行先サーバーと移行元サーバーに Windows Server 移行ツールをインストールします。 移行ツールは、PowerShell またはサーバー マネージャーを使用してインストールできます。

PowerShell の場合は、 Install-WindowsFeature コマンドレットを使用します。

Install-WindowsFeature -Name Migration -ComputerName Server1

サーバー マネージャーを使用して、役割と機能の追加ウィザードを開きます。 Windows Server 移行ツールの機能を見つけてインストールします。

移行先サーバーを準備する

移行先サーバーに DHCP サーバーをインストールするには、メニュー 駆動型のインストール プロセスを完了します。 移行先サーバーを準備するには、次の手順を実行します。

移行先サーバーを準備するには

  1. Windows Server をインストールし、移行先サーバーを構成します。

  2. DHCP サーバー データベースを格納するための十分なディスク領域があることを確認します。 必要なディスク領域はインストールごとに異なり、DHCP サーバー データベースの領域以上にする必要があります。

  3. 置き換えられる移行元サーバーのドメインに、移行先サーバーをメンバー サーバーとして追加します。

  4. インポート操作中に、移行先サーバーがローカル グループのメンバーであるドメイン ユーザーの名前を解決できることを確認します。 移行元サーバーと移行先サーバーが異なるドメインにある場合、移行先サーバーは、ソース ドメイン ユーザー アカウントが存在するフォレストのグローバル カタログ サーバーに接続できる必要があります。

  5. Windows Server を実行しているコンピューターで、管理者として Windows PowerShell を開きます。

  6. サーバー マネージャー モジュールを Windows PowerShell セッションに読み込みます。 サーバー マネージャー モジュールを読み込むには、次のコマンドを入力します。

    Import-Module -Name ServerManager
    

    設定をインポートする前に、DHCP サーバーを移行先サーバーにインストールすることは必須ではありません。 ロールが移行先サーバーにインストールされていない場合は、インポート プロセス中に自動的にインストールされます。 ただし、インポート中にロールをインストールするとダウンタイムが長くなるため、移行の準備の一環として、移行先サーバーにサーバー マネージャー コンソールを使用して DHCP サーバーをインストールすることをお勧めします。

  7. 移行先サーバーで DHCP サーバーをインストールするには、次のコマンドを実行します。

    Install-WindowsFeature -Name DHCP
    

サーバー マネージャーを使用して DHCP サーバーを手動でインストールすることもできます。 詳細については、「 DHCP サーバーのインストールと構成」を参照してください。

  1. 移行プロセスの終了までに、移行先サーバーには静的 IP アドレスが必要です。 移行先サーバーの IP アドレスは変更しませんが、移行が完了したときに変更する準備として、次のシナリオを検討してください。

    • 移行シナリオで移行元サーバーを使用停止にしてネットワークから切断する必要がある場合は、移行先サーバーの IP アドレスを移行元サーバーの IP アドレスと同じにすることができます。 移行元サーバーと移行先サーバーの間で IP アドレスの競合が発生しないように、ソース サーバーをネットワークから切断するか、シャットダウンする必要があります。 ただし、移行先サーバーは、DHCP サーバーを実行していたレガシ (ソース) サーバーを検索しているクライアントに引き続きサービスを提供できます。

    • 移行シナリオで、他の DHCP 以外の目的でネットワーク上のソース サーバーを引き続き実行する必要がある場合は、IP の競合を回避するために、移行先サーバーに、移行元サーバーと同じサブネット内の未割り当て IP アドレスを割り当てる必要があります。

    • IP アドレスのリースを更新しようとする DHCP サーバー クライアントは、DHCP サーバーの以前の IP アドレスに更新要求を送信します。 移行元サーバーが使用停止になり、ネットワークから切断され、新しい DHCP 宛先サーバーが別の IP アドレスで動作している場合、この要求は最初は IP アドレスが変更されたため失敗します。 ただし、クライアントはネットワーク上の DHCP サーバーの IP アドレスを再検出しようとするため、この一時的な障害から復旧します。

    警告

    ソース サーバーが複数のロールを実行している場合は、ソース サーバーの名前を変更するか、その IP アドレスを変更すると、ソース サーバーで実行されている他のロールが失敗する可能性があります。

  2. DHCP サーバー データベース パスが既定のパスと一致しない場合は、移行先サーバーの DHCP サーバー データベース パスに表示されるドライブ文字が同じディスクがあることを確認する必要があります。

移行先サーバーの移行準備が整いました。

ソース サーバーを準備する

移行元サーバーを移行用に準備するには、次の手順に従います。

  1. ソース サーバーをバックアップします。 バックアップは、Windows バックアップではなく、DHCP サーバー固有のバックアップにする必要があります。 (Windows バックアップでは、オペレーティング システム全体がバックアップされます)。DHCP サーバー固有のバックアップは、 Netsh コマンド ライン ツール または Microsoft 管理コンソール (MMC) を使用して作成できます。

  2. 実行されている場合は、DHCP サーバー サービスを停止します。 宛先サーバーを準備する手順 5 で説明したように開かれたセッションで、次のように入力します。

    Stop-Service -Name "DHCPserver"
    
  3. DHCP サーバー のデータベース パスが既定のパスと一致しない場合は、移行先サーバーの DHCP サーバー データベース パスと同じドライブ文字を持つディスクがあることを確認します。

これで、DHCP サーバーの移行を開始する準備ができました。

DHCP サーバーの役割を移行する

このセクションでは、DHCP サーバーを移行元サーバーから移行先サーバーに移行します。 これらの手順を完了するには、ドメイン管理者または同等のメンバーシップが最低限必要です。

DHCP サーバーを移行先サーバーに移行する

  1. まだインストールされていない場合は、移行先サーバーに DHCP サーバーをインストールします。

  2. 実行中の場合は、次のコマンドを実行して DHCP サーバー サービスを停止します。

    Stop-Service -Name "DHCPserver"
    

移行元サーバーから DHCP サーバーを移行する

ソース サーバーから DHCP サーバーを移行するには、このセクションの手順に従います。

重要

Import-SmigServerSettingExport-SmigServerSetting、または Get-SmigServerFeature コマンドレットを実行する前に、移行中に、移行元サーバーと移行先サーバーの両方が、ソース サーバー上のローカル グループのメンバーであるドメイン ユーザーまたはグループに関連付けられているドメイン コントローラーに接続できることを確認します。 Send-SmigServerData または Receive-SmigServerData コマンドレットを実行する前に、移行中に、移行するファイルまたは共有を所有するドメイン ユーザーに関連付けられているドメイン コントローラーに移行元サーバーと移行先サーバーの両方が接続できることを確認します。

  1. Windows Server を実行しているコンピューターで、管理者として Windows PowerShell を開きます。

  2. セッションに Windows Server 移行ツールを読み込みます。

    [スタート] メニューの [Windows Server 移行ツール] ショートカットを使用して現在のセッションを開いた場合は、この手順をスキップして、手順 3 に進みます。 他の方法で開かれたセッションにおいて、まだスナップインが読み込まれていない場合にのみ、Windows Server 移行ツール スナップインを読み込んでください。 Windows Server 移行ツールを読み込むには、次のように入力し、Enter キーを押 します

    Add-PSSnapin Microsoft.Windows.ServerManager.Migration
    
  3. Export-SmigServerSetting コマンドレットを管理者として実行して、ソース サーバーからデータを収集します。 Export-SmigServerSetting コマンドレット パラメーターは、すべてのソース DHCP サーバー データを 1 つのファイル (Svrmig.mig) で収集できます。 または、 Export-SmigServerSetting コマンドレットを複数回実行できます。各イテレーションでは、1 つ以上のパラメーターを使用して、複数の Svrmig.mig ファイルにデータを収集して格納します。 このコマンドを実行する前に、次の内容を確認してください。

    • 手順 4 でコマンドを実行すると、移行ストア データを暗号化するためのパスワードを入力するように求められます。 移行ストアからインポートするには、これと同じパスワードを指定する必要があります。

    • path パラメーターには、空のディレクトリまたは空でないディレクトリを指定できます。 ディレクトリ内の実際のデータ ファイル (Svrmig.mig) は、 Export-SmigServerSetting コマンドレットによって作成されます。 そのため、ユーザーはファイル名を指定する必要はありません。

    • パスが移行先サーバーが読み取ることができる共有の場所ではない場合は、移行ストアを移行先サーバーまたは移行先サーバーがアクセスできる場所に手動でコピーする必要があります。

    • 移行ストアの場所が既に存在し、 Export-SmigServerSetting コマンドレットを再実行する場合は、その場所から Svrmig.mig ファイルを移動し、別の場所に保存し、移行ストアの名前を変更するか、最初に削除する必要があります。

    • 1 つのコマンド ラインで Export-SmigServerSetting コマンドレットと IPConfig スイッチを組み合わせて使用することで、Windows PowerShell プロンプトから IP と DHCP サーバーの両方の移行を同時に実行できます。

    • 追加のコマンド ライン パラメーター情報:

      • -Users パラメーターと -Group パラメーター

        -Users パラメーターは、DHCP Administrators グループにローカル ユーザーが含まれている場合にのみ指定する必要があります。 それ以外の場合は、 -Group パラメーターを使用でき、DHCP 管理者のすべてのメンバーが移行されます。 管理者グループのメンバーには、ドメイン ユーザーを含めることができます。

        重要

        移行元サーバーがドメイン コントローラーであっても、移行先サーバーではない場合、ドメイン ローカル グループはローカル グループとして移行され、ドメイン ユーザーはローカル ユーザーとして移行されます。

      • -IPConfig パラメーターは、ソース サーバー上の Export-SmigServerSetting コマンドレットで使用されるときに IP 情報を収集します。-IPConfig パラメーターは、インポート先サーバーで Import-SmigServerSetting コマンドレットを使用するときに設定を適用します。

        ソース DHCP サーバーに複数のネットワーク アダプターがあり、DHCP サーバー サービスが複数のネットワーク アダプターにバインドされ、異なるサブネット上の IP アドレスを提供する場合、移行先 DHCP サーバーには、ソース DHCP サーバーと同じサブネットを提供できるように、複数のネットワーク アダプターも必要です。 IP 構成の詳細は後で IP 構成設定を宛先サーバーにインポートするときに使用されるため、次のコマンドを使用して IP 構成設定を保存することをお勧めします: IPConfig /all > IPSettings.txt

        Import-SmigServerSetting コマンドレットでは、ソース物理アドレスを宛先の物理アドレスにマップする必要があります。

      移行元サーバー上の他の役割を引き続き実行する必要がある場合を除き、移行先サーバーには移行元サーバーと同じ静的 IP アドレスを割り当てることができます。 その場合、移行先サーバーの静的 IP アドレスは、移行元サーバーと同じサブネット内の任意の未割り当て静的 IP アドレスにすることができます。

  4. ソース サーバーで Export-SmigServerSetting コマンドレットを実行します。ここで、<storepath> は、この手順の完了後に Svrmig.mig ファイルを含むパスです。 パスの例として、\\fileserver\users\username\dhcpstore があります。

    Export-SmigServerSetting -featureID DHCP -User All -Group -IPConfig -path <storepath> -Verbose
    
  5. ソース サーバーで、次のコマンドを実行して、ソース DHCP サーバーの DHCP 承認を削除します。 ここで、サーバー FQDN は DHCP サーバーの完全修飾ドメイン名 (FQDN) で、 サーバー IPAddress はサーバーの IP アドレスです。 コマンド パラメーターでは大文字と小文字が区別されるので、示されているとおりに入力する必要があります。

    Netsh DHCP delete server <Server FQDN> <Server IPAddress>
    

移行先サーバーで移行を完了する

移行先サーバーに戻り、次の手順に従って移行を完了します。

  1. Import-SmigServerSetting コマンドレットを使用して DHCP サーバー設定をインポートする前に、次の条件に注意してください。

    • すべてのパラメーターで 1 つのコマンド ラインを使用して DHCP 設定をインポートするか (ソース サーバーからデータをエクスポートする場合と同様)、コマンドレットを複数回使用してデータを一度に 1 つのパラメーターにインポートできます。

    • IP 設定を インポートするために Import-SmigServerSetting コマンドレットを個別に実行する場合は、前の手順の手順 3 で参照したソース IPSettings.txt ファイルを使用します。 この手順の手順 3 で、ソース物理アドレスを宛先の物理アドレスにマップします。 ロールと IP 設定を個別にインポートする場合は、IP の競合を回避するために、まず IP 設定をインポートする必要があります。 その後、DHCP ロールをインポートできます。

    • DHCP Administrators グループにローカル ユーザーが含まれている場合は、 -Users パラメーターと -Group パラメーターを組み合わせて使用して、ローカル ユーザーを DHCP Administrators グループにインポートします。 ドメイン ユーザーのみが含まれている場合は、 -Group パラメーターのみを使用します。

    移行元サーバーがドメイン メンバー サーバーで、移行先サーバーがドメイン コントローラーである場合、インポートされたローカル ユーザーはドメイン ユーザーに昇格され、インポートされたローカル グループは移行先サーバーのドメイン ローカル グループになります。

    • 移行する DHCP サーバーの役割が移行先サーバーにインストールされていない場合、 Import-SmigServerSetting コマンドレットは、その DHCP サーバーの役割とその依存関係をインストールします。 コマンドレットによって DHCP サーバーの役割がインストールされた後にインストールを完了するには、移行先コンピューターを再起動する必要がある場合があります。 次に、コンピューターを再起動した後にインポート操作を完了するには、-Force パラメーターと共に Import-SmigServerSetting コマンドレットをもう一度実行する必要があります。
  2. 移行先サーバーで、次のコマンドを実行します。 ここで、<storepath> は、Svrmig.mig ファイル、< を含む使用可能なパスです>は、ソース ネットワーク アダプターの物理アドレスのコンマ区切りリスト、および <TargetPhysicalAddress-1> および <TargetPhysicalAddress-2 です>は、宛先ネットワーク アダプターの物理アドレスのコンマ区切りのリストです。

    Import-SmigServerSetting -FeatureID 'DHCP' -User All -Group -IPConfig <All | Global | NIC>
        -SourcePhysicalAddress <SourcePhysicalAddress-1>,<SourcePhysicalAddress-2>
        -TargetPhysicalAddress <TargetPhysicalAddress-1>,<TargetPhysicalAddress-2>
        -Force -Path <storepath> -Verbose
    

    ユーザーがすべてのソース設定をインポートする場合は、 -IPConfig スイッチを値 All と共に使用する必要があります。

    重要

    ソース サーバーの IP アドレスを、ソース サーバーの IP アドレスを切断または変更せずに DHCP ロールと共にターゲット サーバーにインポートすると、IP アドレスの競合が発生します。

  3. 次のコマンドを実行して DHCP サービスを開始します。 Start-Service -Name "DHCPServer"

  4. 移行先サーバーを承認します。 コマンド パラメーターでは大文字と小文字が区別されるので、示されているとおりに入力する必要があります。 移行先サーバーで、次のコマンドを実行 します。ここで、サーバー FQDN は DHCP サーバーの FQDN、 サーバー IPAddress はサーバーの IP アドレスです。

    netsh DHCP add server <Server FQDN> <Server IPAddress>
    

この移行が完了すると、ネットワーク サーバー上のクライアント コンピューターは、Windows Server を実行している新しい x64 ベースの移行先サーバーによって処理されます。 移行先サーバーが IP アドレスをネットワークに提供する準備ができたら、移行が完了します。

移行を検証する

すべての移行手順が完了したら、次の手順を使用して、DHCP サーバーロールの移行が成功したことを確認できます。 移行に失敗した場合は、「 移行後のタスク」の手順に従って、以前の有効な構成に戻ることができます。

移行先サーバーの構成を確認する

次の手順に従って、DHCP 宛先サーバーがドメインにサービスを提供していることを確認します。

  1. Windows PowerShell ウィンドウで次のコマンドを実行して、移行先サーバーが承認されていることを確認します。

    netsh DHCP show server
    

    このコマンドの出力には、DHCP 宛先サーバーの名前が含まれている必要があります。

  2. DHCP サーバーが移行先サーバーで実行されているかどうかを確認します。 タスク マネージャーの [ サービス ] タブで、DHCP サーバーの状態が [開始] になっている必要があります。 また、タスク マネージャーを使用して、ソース サーバーの状態が 停止していることを確認します。

  3. クライアント コンピューターのコマンド プロンプトで次のコマンドを実行して、クライアント コンピューターが要求時に IP アドレスを正しく受信していることを確認します。

    ipconfig /release
    
    ipconfig /renew
    

    DHCP サーバーの IP アドレスが変更されていない場合は、 ipconfig /release コマンドを実行する必要はありません。 ipconfig /renew を実行するだけで十分です。

    これらのコマンドの出力は、クライアント コンピューターが IP アドレスを発行されたことを示しているはずです。

  4. DHCP コンソールを使用して、スコープとその他の設定が移行されたことを確認します。 宛先サーバーに接続するには、[ アクション] を選択し、[ サーバーの追加] を選択し、DHCP サーバーの IP アドレスまたはホスト名を入力します。 コンソール ツリーで、サーバー ノードを展開し、IPv4 ノードと IPv6 ノードを展開して、スコープが移行されたことを確認します。 次に、スコープのフォルダーを見つけ、アドレス範囲、予約、スコープ オプション、アクティブなリースを表示して、同じ内容を確認します。 [サーバー オプション] フォルダーに移動し、移行されたサーバー オプションを確認することもできます。

移行後タスク

移行シナリオに応じて、ソース サーバーの移行後のこれらのタスクは省略可能です。

移行元サーバーではなく移行先サーバーがネットワークにサービスを提供していることを確認した後、移行が完了します。

ソース サーバーで DHCP を廃止する

移行を確認したら、ソース サーバーの切断、再利用、または廃止を行うことができます。 ソース サーバーが他のサーバー ロールを実行している場合は、ネットワーク上に残しておく必要があります。 このコンピューターを使用する必要がない場合は、以前の DHCP 構成に戻す必要がある場合に備えて、バックアップとして保存できます。

移行シナリオにスタンドアロン DHCP サーバーが含まれている場合、このソース サーバーはエクスポート ファイルの作成後にオフラインになりました。 このシナリオでは、DHCP サービスが停止されてから、新しいサーバーで移行が完了するまで中断されました。

移行シナリオにドメインに複数の DHCP サーバーが含まれている場合、バックアップまたは他の DHCP サーバーは移行中も引き続き IP アドレスを処理し、クライアントへのサービスが中断されないようにします。 移行元サーバーの IP アドレスが移行先サーバーに移行されると、新しいサーバーで移行が完了します。

ソース サーバーを廃止する

移行先サーバーが以前にソース サーバーによって処理された機能を実行していることを確認したら、必要に応じて、移行元サーバーを廃止または再利用できます。 サーバーの使用停止に関する組織のポリシーに従います。 ドメイン コントローラーの使用停止の詳細については、「ドメイン コントローラー とドメインの降格」を参照してください。

移行が失敗した場合に DHCP を復元する

DHCP サーバーの移行が失敗した場合は、次のオプションがあります。

  • ソース サーバーが再利用されていない場合、管理者は IP 構成設定の再割り当て、サーバーの再認証、元のサーバーでの DHCP サービスの再起動を行うことができます。
  • ソース サーバーで作成されたバックアップ ファイルを使用して、元の DHCP サーバー上の DHCP サーバーを復元します。

コマンドレットベースの移行のトラブルシューティング

Windows Server 移行ツールの展開ログ ファイルは、 windir%\Logs\SmigDeploy.log %にあります。 その他の Windows Server 移行ツールのログ ファイルは、次の場所に作成されます。

  • % windir%\Logs\ServerMigration.log

  • % localappdata%\SvrMig\Log

移行ログ ファイルを前の場所に作成できない場合、ServerMigration.logSmigDeploy.log は %temp%に作成され、その他のログは %windir%\System32 に作成されます。

DHCP 固有のトラブルシューティングのヒントについては、「 DHCP サーバーでの問題のトラブルシューティング」を参照してください。

移行元サーバーまたは移行先サーバーとドメイン コントローラーまたはグローバル カタログ サーバーの間の接続を復元できない場合

  1. Export-SmigServerSettingImport-SmigServerSetting、または Get-SmigServerFeature をもう一度実行する前に、コマンドレットを実行しているサーバーから、ローカル グループのメンバーである未解決のドメイン ユーザーまたはグループをすべて削除します。

  2. Send-SmigServerData または Receive-SmigServerData を再度実行する前に、移行元サーバー上のファイル、フォルダー、または共有に対するユーザー権限を持つ未解決のドメイン ユーザーまたはグループをすべて削除します。

Windows Server 移行ツールの結果オブジェクトの内容を表示する

すべての Windows Server 移行ツール コマンドレットは、結果をオブジェクトとして返します。 結果オブジェクトを保存し、クエリを実行して、移行された設定とデータの詳細を確認できます。 他の Windows PowerShell コマンドやスクリプトの入力として結果オブジェクトを使用することもできます。

結果オブジェクトの説明

Windows Server Migration Tools Import-SmigServerSetting コマンドレットと Export-SmigServerSetting コマンドレットは、 MigrationResult オブジェクトの一覧で結果を返します。 各 MigrationResult オブジェクトには、コマンドレットが処理するデータまたは設定、操作の結果、および関連するエラーまたは警告メッセージに関する情報が含まれます。 次の表では、 MigrationResult オブジェクトのプロパティについて説明します。

プロパティ名 タイプ 定義
アイテムの種類 列挙型 移行する項目の種類。 値には、 GeneralWindowsFeatureInstallationWindowsFeatureOSSetting が含まれます。
身分証明書 移行された項目の ID。 値の例としては、 ローカル ユーザーローカル グループDHCP などがあります。
成功 ボーリアン 移行が成功した場合、 値 True が表示されます。それ以外の場合は False が表示されます。
ディテールリスト List<MigrationResultDetails> MigrationResultDetails オブジェクトの一覧。

Send-SmigServerData コマンドレットと Receive-SmigServerData コマンドレットは、 MigrationDataResult オブジェクトの一覧で結果を返します。 各 MigrationDataResult オブジェクトには、コマンドレットが処理するデータまたは共有に関する情報、操作の結果、エラーまたは警告メッセージ、およびその他の関連情報が含まれます。 次の表では、 MigrationDataResult オブジェクトのプロパティについて説明します。

プロパティ名 タイプ 定義
アイテムの種類 列挙型 移行された項目の種類。 値には、 ファイルフォルダー共有および暗号化されたファイルが含まれます
ソースロケーション パスとして表示される項目のソースの場所。
目的地ロケーション パスとして表示される項目の移動先の場所。
成功 ボーリアン 移行が成功した場合、 値 True が表示されます。それ以外の場合は False が表示されます。
サイズ 整数 項目のサイズ (バイト単位)。
エラーの詳細 List<MigrationResultDetails> MigrationResultDetails オブジェクトの一覧。
エラー 列挙型 発生したエラーのエラー列挙。
警告メッセージ一覧 List<String> 警告メッセージの一覧。

次の表では、MigrationResult オブジェクトと MigrationDataResult オブジェクトの両方に共通する MigrationResultDetails オブジェクト内のオブジェクトのプロパティについて説明します。

プロパティ名 タイプ 定義
FeatureId 項目に関連する移行設定の名前。 値の例としては、 IPConfigDNS があります。 データ移行の場合、このプロパティは空です。
メッセージ List<String> 詳細なイベント メッセージの一覧。
詳細コード 整数 各イベント メッセージに関連付けられているエラーまたは警告コード。
深刻さ 列挙型 イベントが発生した場合のイベントの重大度。 値の例としては、 情報エラー警告などがあります。
タイトル 結果オブジェクトのタイトル。 値の例としては、IP 構成のネットワーク アダプターの物理アドレスや、ローカル ユーザー移行のユーザー名などがあります。