PowerShell コマンドレットは、Migration Manager サービスで実行されているファイル共有の移行タスクを管理し、スキャンと移行のレポートをダウンロードするように設計されています。
コンピューターがシステム要件を満たしていることを確認するには、この リンク を参照してください。
始める前に
Migration Manager ファイル共有の移行を開始するには:
- Migration Manager エージェントをインストールし、管理者アカウントを使用して移行先テナントに接続します。
- 管理者として SharePoint 管理 センターにサインインし、[移行/ファイル共有] に移動します。
ここで PowerShell zip ファイルをダウンロードし、ビルドを作業フォルダーに解凍します
PowerShell コマンドレットを使用する
管理者として PowerShell を起動する
以下のコマンドを実行します。
> Get-ChildItem -Path "working_folder" -Recurse | Unblock-File
> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
最初の PowerShell ウィンドウを閉じて、管理者として PowerShell を起動します
以下のコマンドを実行します。
> Import-Module "working_folder\Microsoft.SharePoint.MigrationManager.PowerShell.dll"
注:
Import-Module コマンドレットに絶対ファイル パスを指定します。
Migration Manager サービスに接続する
> Connect-MigrationService
このコマンドレットは、Migration Manager サービスに接続します。 接続が確立されたら、移行タスクを追加して移行を開始できます。
移行タスクを追加する
> Add-MigrationTask
このコマンドレットを使用して、新しい移行タスクを作成します。 作成後、タスクは [移行マネージャー] ページに表示されます。
次のパラメーターが必要です。
TaskName: 移行タスクの名前を指定します。
SourceUri: ソース ファイル のパスを定義します。
TargetSiteUrl: コピー先の SharePoint サイト URL を示します。
TargetListName: 対象の SharePoint リストの名前を指定します。
省略可能なパラメーター:
ScheduleStartTime: タスクの実行を開始する時間を指定します。 既定では、タスクを追加した直後にタスクが開始されます。
AgentGroup: タスクを実行するエージェント グループを割り当てます。 既定では、"既定" グループが割り当てられます。
タグ： タスクにタグを割り当てます。 複数のタグを割り当てるには、セミコロンを使用してタグ値を区切ります。
出力メッセージ:
タスクが移行サービスに正常に追加された場合は、「移行タスクは タスク ID taskId で作成されます」。
"移行タスクの追加に失敗しました。 errorMessage" コマンドレットがエラーアウトした場合。
サポートされているパラメーターの完全な一覧については、次を実行します。
> Get-Help Add-MigrationTask -Full
移行レポートを取得する
> Get-MigrationReport
指定したパラメーターに基づいて完了した移行タスクのレポートを取得するには、次のコマンドレットを使用します。
OutputPath: 生成されたレポートを保存するディレクトリ パスを指定します。
StartTime: 指定した日時以降に開始された移行タスクをフィルター処理します。
EndTime: 指定した日時より前に開始された移行タスクをフィルター処理します。
TaskNameContains: 指定したキーワード (keyword)を含む名前を持つ移行タスクをフィルター処理します。
タグ: タグが指定されたパラメーターと同じ移行タスクをフィルター処理します。 複数のタグが指定されている場合は、セミコロン (;)で区切られた場合、タグが tags パラメーター内の 1 つと同じであるすべてのタスクを返す必要があります。
状態: 状態が指定されたパラメーターと同じ移行タスクをフィルター処理します。 サポートされている値は [完了] と [失敗] です。 既定では、 完了した タスクと 失敗した タスクのレポートがダウンロードされます。
パラメーターが指定されていない場合、コマンドレットは既定ですべての 完了 レポートと 失敗レポート をダウンロードします。
出力メッセージ:
レポート zip ファイルがダウンロードされている場合は、各タスクの "タスク taskeId 用にダウンロードされたレポート" です。 最後のメッセージは、要約行 "移行レポートのダウンロードが完了しました。出力フォルダーチェック: outputPath" です。
"移行レポートのダウンロードに失敗しました。 errorMessage" コマンドレットがエラーアウトした場合。
サポートされているパラメーターの完全な一覧については、次を実行します。
> Get-Help Get-MigrationReport -Full
スキャン レポートを取得する
> Get-ScanReport
指定したパラメーターに基づいて完了したスキャン タスクのレポートを取得するには、このコマンドレットを使用します
OutputPath: 生成されたレポートを保存するディレクトリ パスを指定します。
StartTime: 指定した日時以降に開始された移行タスクをフィルター処理します。
EndTime: 指定した日時より前に開始された移行タスクをフィルター処理します。
タグ: タグが指定されたパラメーターと同じ移行タスクをフィルター処理します。 複数のタグが指定されている場合は、セミコロン (;)で区切られた場合、タグが tags パラメーター内の 1 つと同じであるすべてのタスクを返す必要があります。
状態: 状態が指定されたパラメーターと同じ移行タスクをフィルター処理します。 サポートされている値は、 準備完了、 警告、 およびエラーです。 既定では、 移行準備完了タスク、 警告タスク、 エラー タスクのレポートがダウンロードされます。
パラメーターが指定されていない場合、コマンドレットは既定ですべての 移行準備完了レポート、 警告レポート、および エラー レポートをダウンロードします。
出力メッセージ:
レポートの zip ファイルがダウンロードされている場合は、タスクごとに "タスク taskeid 用にダウンロードされたログをスキャンする" 。 最後のメッセージは、"完了したログのダウンロードをスキャンし、出力フォルダー outputPath をチェックする" という概要行です。
"スキャン ログのダウンロードに失敗しました。 コマンドレットでエラーが発生した場合は、"error_message" を指定します。
サポートされているパラメーターの完全な一覧については、次を実行します。
> Get-Help Get-ScanReport -Full