注: PowerShell 統合には、ShareGate の Migration Pro または Migration Ultimate パッケージが必要です。Migration Essentials Mailbox または Migration Essentials Files パッケージでは利用できません。
PowerShell を使用して、OneDrive for Business から OneDrive for Business への移行を自動化できます。
ヒント: ドキュメントを新しい OneDrive フォルダーに移行するには、Walkthrough - Migrate to a new OneDrive folder in PowerShell をご覧ください。
注: 2026 年 1 月末に、Microsoft は IDCRL Cookie の廃止を開始しました。そのため、ほとんどの Microsoft 365 テナントでは、-Browser パラメーターと -ModernAuth パラメーターを使用する Browser 認証と Modern authentication の方法のみが機能します。この変更の詳細については、Important change to "Other user" authentication for Microsoft 365 をご覧ください。
前提条件
移行元テナントと移行先テナントのグローバル管理者または SharePoint 管理者であること。このロールは、スクリプトで使用する OneDrive のルート URL (例:
https://tenantname-my.sharepoint.com/) に接続するために必要です。移行対象のすべての OneDrive のサイト コレクション管理者 (SCA) であること。OneDrive の SCA 権限をまだお持ちでない場合は、グローバル管理者または SharePoint 管理者の権限が必要です。以下の手順 7 から 12 で説明しています。
OneDrive がプロビジョニング済みであること (Get-OneDriveURL cmdlet で自動化できます)。
注: より上位の管理者権限をお持ちの場合でも、各 OneDrive のサイト コレクション管理者 (SCA) である必要があります。以下の手順 7 から 12 では、SharePoint 管理者またはグローバル管理者の権限を使用して、すべての OneDrive に自分自身を SCA として追加します。対象のすべての OneDrive ですでに SCA である場合は、手順 7 から 12 を省略できます。PowerShell スクリプトは、各 OneDrive の移行時に SCA 権限を削除します。SharePoint 管理者はすべての OneDrive にアクセスできますが、ShareGate Migrate のほとんどの操作にはサイト コレクション管理者の権限が必要です。
手順
OneDrive for Business の移行では、移行元と移行先のすべての OneDrive を CSV ファイルに一覧化し、これらのパラメーターをループ処理して各 OneDrive をコピーする PowerShell スクリプトを作成する必要があります。
移行用の CSV ガイドを作成する
All reports に移動します。
右上隅の Create custom report をクリックします。
オブジェクトの種類として OneDrive for Business を選択します。
Continue without saving をクリックします。
移行元のテナントを選択します。
Run をクリックします。
一覧の上部にあるチェック ボックスを使用して、すべての OneDrives を選択します。
Quick actions menu で Edit をクリックします。
Transformations ドロップダウンで Add administrators を選択します。
表示される Select user or group フィールドで、自分のアカウントを検索して追加します。
Apply をクリックします。
Back を 2 回クリックして、レポートの結果に戻ります。
右上隅の Export をクリックします。
ファイルをドライブに保存します。
手順 (1) から (14) を繰り返します。ただし、手順 (5) では移行先のテナントを選択します。
Excel を開きます。
最初の 2 つの列に、タイトルとして SourceSite と DestinationSite を追加します。
手順 (14) と (15) で保存した 2 つのファイルを開きます。
両方のファイルのデータを新しいドキュメントにまとめ、それぞれの列で移行元 URL と移行先 URL が対応するようにします。
アルファベット順の並べ替えがうまくいかない場合は、データを手動で並べ替えるか、Excel マクロや PowerShell を使って対処できます。この新しいファイルを CSV としてドライブに保存します。
スクリプトを作成する
次のスクリプトをコピーして、お使いの PowerShell アプリケーションに貼り付けます。
Import-Module Sharegate
# Define the CSV file path
$csvFile = "C:\CSV\CopyContent.csv"
# Import the CSV file
$table = Import-Csv $csvFile -Delimiter ","
# Define the source and destination connections
$srcSiteConnection = Connect-Site -Url "https://sourcetenantname-my.sharepoint.com/" -ModernAuth
$dstSiteConnection = Connect-Site -Url "https://destinationtenantname-my.sharepoint.com/" -ModernAuth
# Set variables for site and list operations
Set-Variable srcSite, dstSite, srcList, dstList
# Loop through each row in the CSV
foreach ($row in $table) {
# Clear previous values of variables
Clear-Variable srcSite
Clear-Variable dstSite
Clear-Variable srcList
Clear-Variable dstList
# Connect to source and destination sites
$srcSite = Connect-Site -Url $row.SourceSite -UseCredentialsFrom $srcSiteConnection
$dstSite = Connect-Site -Url $row.DestinationSite -UseCredentialsFrom $dstSiteConnection
# Get source and destination lists
$srcList = Get-List -Site $srcSite -Name "Documents"
$dstList = Get-List -Site $dstSite -Name "Documents"
# Copy content from source list to destination list
Copy-Content -SourceList $srcList -DestinationList $dstList
# Remove site collection administrator permissions
Remove-SiteCollectionAdministrator -Site $srcSite
Remove-SiteCollectionAdministrator -Site $dstSite
}
お使いの環境で動作するようにスクリプトを調整します。次のガイドラインを参考にしてください。
$csvFile: 先ほど保存した CSV ファイルを指すようにパスを調整します。
$table: 区切り文字は、CSV で行内の項目を区切るために使用されている記号です。スクリプトで、ファイルと同じ区切り文字を使用していることを確認してください (メモ帳で CSV を開くと簡単に確認できます)。
$srcSiteConnection と $dstSiteConnection: URL を、移行元テナントと移行先テナントそれぞれの OneDrive のルート URL に置き換えます。この URL に接続するには、グローバル管理者または SharePoint 管理者の権限が必要です。
Connect-site: SharePoint サイトまたは OneDrive for Business に接続するコマンドです。認証方法を Modern authentication から変更する必要がある場合は、Connect Site をご覧ください。
Set-Variable と Clear-Variable: これらのコマンドは、接続エラーによってデータが誤った OneDrive に移行されてしまう問題を防ぐのに役立ちます。
foreach: CSV ファイルの値をループ処理するために foreach を使用します。詳細についてはこちらをご覧ください。
-UseCredentialsFrom: このスクリプトは、1 つの接続を再利用するために、-UseCredentialsFrom パラメーターで Modern authentication を使用します。スクリプトの開始時に、Microsoft 365 の資格情報の入力を求められます。テナントで MFA が強制されていない場合は、無人でのスケジュール実行のために、ユーザー名とパスワードを使用するようにスクリプトを設定できます。詳細については、Connect-Site と Avoid repeatedly entering your credentials with the browser and modern connection methods をご覧ください。
Remove-SiteCollectionAdministrator: この関数は、OneDrive の移行後に、お使いのユーザー アカウントをサイト コレクション管理者から削除します。詳細については、Remove Site Collection Administrator をご覧ください。
スクリプトを適切に調整してテストしたら、実行します。
考慮事項
-ModernAuth を使用する Modern authentication は、Microsoft 365 で最も安全で持続性のある認証方法です。多要素認証 (MFA) が強制されていない場合は、Username 変数と Password 変数と組み合わせて使用できます。いくつかの制限もあります。この接続方法のさまざまな使い方や、必要に応じて Browser authentication に切り替える方法については、Connect-Site をご覧ください。
移行レポートは自動的に生成され、Tasks で確認できます。スクリプトで Export-Report を使用して、レポートをエクスポートすることもできます。
PowerShell を使用すると、移行をスケジュールして、営業時間外に実行し、パフォーマンスを最適化できます。
増分移行を実行するには、Incremental update using PowerShell の記事をご覧ください。
ShareGate Migrate のコピー オプションを再現するには、Copy options in PowerShell をご覧ください。
移行するデータが数百ギガバイトある場合は、複数の CSV を作成して、小さなバッチに分けて移行することをお勧めします。
スクリプトのエラーとテスト: PowerShell スクリプトを広く適用する前に、少数の OneDrive アカウントでテストしてください。テストを行うと、管理された範囲で潜在的な問題を特定できます。
多言語対応の組織: Microsoft 365 環境で複数の表示言語を使用している場合、スクリプトの
-Nameに渡すライブラリ名が、ライブラリの実際の表示名と一致しないことがあります。たとえば、ドイツ語環境では Documents ライブラリの名前が Dokumente になっている場合があり、その結果スクリプトが失敗します。詳細については、Cannot validate argument on parameter 'List' - multilingual organizations をご覧ください。
この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。
