注: PowerShell 統合には、ShareGate の Migration Pro または Migration Ultimate パッケージが必要です。Migration Essentials Mailbox または Migration Essentials Files パッケージでは利用できません。
コンテンツを多数の OneDrive にコピーする PowerShell スクリプトのいずれかを実行する際に、OneDrives に新しいフォルダーを直接プロビジョニングすることはできません。
このガイドでは、移行スクリプトを実行する前に、移行元のファイルをコピーするための新しいフォルダーを OneDrive に追加する方法を説明します。
注: 2026 年 1 月末に、Microsoft は IDCRL Cookie の廃止を開始しました。そのため、ほとんどの Microsoft 365 テナントでは、-Browser パラメーターと -ModernAuth パラメーターを使用する Browser 認証と Modern authentication の方法のみが機能します。この変更の詳細については、Important change to "Other user" authentication for Microsoft 365 をご覧ください。
前提条件
各 OneDrive のサイト コレクション管理者 (SCA) であること。OneDrive の SCA 権限をまだお持ちでない場合は、グローバル管理者または SharePoint 管理者の権限が必要です。スクリプトの準備セクションの手順 11 から 14 で説明しています。
OneDrive がプロビジョニング済みであること (Get-OneDriveURL cmdlet で自動化できます)。
Explorer で Microsoft 365 管理センターに接続していること。
注: より上位の管理者権限をお持ちの場合でも、各 OneDrive のサイト コレクション管理者 (SCA) である必要があります。スクリプトの準備セクションの手順 11 から 14 では、SharePoint 管理者またはグローバル管理者の権限を使用して、自分自身を SCA として追加します。対象のすべての OneDrive ですでに SCA である場合は、手順 11 から 14 を省略できます。
このガイドでは、サイト コレクション管理者の権限を削除しません。この手順は、他の PowerShell での OneDrive 移行ガイドに含まれているためです。
スクリプトの準備
次の手順で、ローカル ドライブにフォルダーを作成し、すべての OneDrive の CSV リストを作成します。
ローカル ドライブに新しいフォルダーを作成します。
OneDrive 内で使用したい名前をフォルダーに付けます (例: C:\Migrated data)。
フォルダーのパスを控えておきます。
ShareGate Migrate で、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 をクリックします。
ファイルをドライブに保存します。
Excel でレポートを開きます。
2 列目にタイトルとして ONEDRIVEURL を追加します。
この新しいファイルを CSV としてドライブに保存します (例: C:\foldermigration.csv)。
CSV ファイルのパスを控えておきます。
ヒント: この CSV リストは、OneDrive の移行でも再利用できます。
スクリプトを作成する
次のスクリプトをコピーして、お使いの PowerShell アプリケーションに貼り付けます。
# Define the CSV file path
$csvFile = "C:\foldermigration.csv"
# Import the CSV file
$table = Import-Csv $csvFile -Delimiter ","
# Define the destination connection
$dstSiteConnection = Connect-Site -Url "https://destinationtenantname-my.sharepoint.com/" -ModernAuth
# Set variables for site and list operations
Set-Variable dstSite, dstList
# Loop through each row in the CSV
foreach ($row in $table) {
# Clear previous values of variables
Clear-Variable dstSite
Clear-Variable dstList
# Connect to the OneDrive site
$dstSite = Connect-Site -Url $row.ONEDRIVEURL -UseCredentialsFrom $dstSiteConnection
# Get the "Documents" list from the destination site
$dstList = Get-List -Name Documents -Site $dstSite
# Import documents from the source file path to the destination list
Import-Document -SourceFilePath "C:\Migrated data" -DestinationList $dstList
}
お使いの環境で動作するようにスクリプトを調整します。次のガイドラインを参考にしてください。
$csvFile: 先ほど保存した CSV ファイルを指すようにパスを調整します。
$table: 区切り文字は、CSV で行内の項目を区切るために使用されている記号です。スクリプトで、ファイルと同じ区切り文字を使用していることを確認してください (メモ帳で CSV を開くと簡単に確認できます)。
$dstSiteConnection: URL を、移行先テナントの OneDrive のルート URL に置き換えます。
Connect-site: SharePoint サイトに接続するコマンドです。認証方法を Browser authentication に変更する必要がある場合は、Connect Site をご覧ください。
Set-Variable と Clear-Variable: これらのコマンドは、接続エラーによってデータが誤った OneDrive に移行されてしまう問題を防ぐのに役立ちます。
foreach: CSV ファイルの値をループ処理するために foreach を使用します。詳細についてはこちらをご覧ください。
-SourceFilePath: "C:\Migrated data" を、手順 (2) で作成したフォルダーのパスに置き換えます。
スクリプトを適切に調整してテストしたら、実行します。
新しいフォルダーにコンテンツを移行する
コンテンツを新しい OneDrive フォルダーに移行するには、OneDrive 移行スクリプトのコピー行に -DestinationFolder "folder name" を追加します (folder name はフォルダーの名前に置き換えてください)。
移行スクリプトのコピー行は、次のようになります。
# Import documents from the source folder to the destination list and folder
Import-Document -SourceFolder $row.DIRECTORY -DestinationList $dstList -DestinationFolder "Migrated data"
この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。
