Eseguire la migrazione a SharePoint con PowerShell

Questo articolo descrive i nuovi cmdlet di PowerShell basati sul motore di migrazione dello strumento di migrazione di SharePoint (SPMT). Possono essere usati per spostare i file dalle raccolte documenti e dagli elementi di elenco locali di SharePoint 2010 e SharePoint 2013 e dalle condivisioni file a Microsoft 365. Per informazioni su tutti i cmdlet di PowerShell correnti relativi alla migrazione di SharePoint, vedere le informazioni di riferimento sui cmdlet dello strumento di migrazione di Microsoft SharePoint.

I cmdlet di PowerShell offrono le stesse funzionalità dello Strumento di migrazione di SharePoint.

Requisiti di sistema

Requisiti consigliati per prestazioni ottimali*

Requisiti minimi (possibile rallentamento delle prestazioni)

Prima di iniziare

1. Effettuare il provisioning di Microsoft 365 con l'active directory esistente o una delle altre opzioni per l'aggiunta di account a Microsoft 365. Per altre informazioni, vedere Integrazione di Microsoft 365 con ambienti locali e Aggiungere utenti a Microsoft 365 Apps for business.

2. Aprire la cartella:

   $env:UserProfile\Documents\WindowsPowerShell\Modules\Microsoft.SharePoint.MigrationTool.PowerShell

   Controllare di avere DLLs al suo interno; se si usa OneDrive, è possibile che sia necessario copiare la cartella WindowsPowershell in OneDrive/Documents.

3. Da questa posizione, eseguire il comando di PowerShell seguente:

   Import-Module Microsoft.SharePoint.MigrationTool.PowerShell
   

Creare e inizializzare una sessione di migrazione

• Register-SPMTMigration
  Questo cmdlet crea e quindi inizializza una sessione di migrazione. L'inizializzazione configura le impostazioni di migrazione a livello di sessione. Se non sono definiti parametri di impostazione specifici, verranno usate le impostazioni predefinite. Dopo aver registrato una sessione, è possibile aggiungere un'attività alla sessione e avviare la migrazione.

Aggiungere un'attività di migrazione

• Add-SPMTTask
  Usare questo cmdlet per aggiungere una nuova attività di migrazione alla sessione di migrazione registrata. Attualmente sono consentiti tre diversi tipi di attività: attività di condivisione file, attività di SharePoint e attività definita JSON. Nota: le attività duplicate non sono consentite.

Rimuovere un'attività

• Remove-SPMTTask
  Questo cmdlet consente di rimuovere un'attività di migrazione esistente dalla migrazione registrata.

Avviare la migrazione

• Start-SPMTMigration
  Questo cmdlet consente di avviare la migrazione tramite SPMT registrata.

Restituire l'oggetto della sessione corrente

• Get-SPMTMigration
  Restituisce l'oggetto della sessione corrente. Questo cmdlet include lo stato delle attività correnti e le impostazioni correnti a livello di sessione. Lo stato corrente dell'attività include:
  • Numero di file analizzati
  • Numero di file migrati
  • Qualsiasi messaggio di errore di migrazione

Interrompere la migrazione corrente

• Stop-SPMTMigration
  Questo cmdlet consente di annullare la migrazione corrente.

Visualizzare i dettagli dello stato della migrazione nella console

• Show-SPMTMigration
  Se si avvia la migrazione in modalità NoShow , l'esecuzione del cmdlet Show-SPMTMigration visualizzerà l'ID attività, la posizione dell'origine dati, il percorso di destinazione e lo stato della migrazione nella console. Premendo CTRL+C si tornerà alla modalità NoShow .

Rimuovere la sessione di migrazione

• Unregister-SPMTMigration
  Utilizzare questo cmdlet per eliminare la sessione di migrazione.

Scenari di esempio

Esempio 1: L'amministratore IT aggiunge un'attività locale di SharePoint e avvia la migrazione in background.

#Define SharePoint 2013 data source#
$SourceSiteUrl = "http://YourOnPremSite/"
$OnPremUserName = "Yourcomputer\administrator"
$OnPremPassword = ConvertTo-SecureString -String "OnPremPassword" -AsPlainText -Force
$SPCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $OnPremUserName, $OnPremPassword
$SourceListName = "SourceListName"

#Define SharePoint target#
$SPOUrl = "https://contoso.sharepoint.com"
$UserName = "admin@contoso.onmicrosoft.com"
$PassWord = ConvertTo-SecureString -String "YourSPOPassword" -AsPlainText -Force
$SPOCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $UserName, $PassWord
$TargetListName = "TargetListName"

#Define File Share data source#
$FileshareSource = "YourFileShareDataSource"

#Import SPMT Migration Module#
Import-Module Microsoft.SharePoint.MigrationTool.PowerShell

#Register the SPMT session with SharePoint credentials#
Register-SPMTMigration -SPOCredential $SPOCredential -Force

#Add two tasks into the session. One is SharePoint migration task, and another is File Share migration task.#
Add-SPMTTask -SharePointSourceCredential $SPCredential -SharePointSourceSiteUrl $SourceSiteUrl  -TargetSiteUrl $SPOUrl -MigrateAll
Add-SPMTTask -FileShareSource $FileshareSource -TargetSiteUrl $SPOUrl -TargetList $TargetListName

#Start Migration in the console. #
Start-SPMTMigration

Esempio 2: l'amministratore IT decide di portare in primo piano la migrazione dalla modalità "NoShow" in background ed esegue il cmdlet in modo da visualizzare l'avanzamento della migrazione nella console.

Show-SPMTMigration

Esempio 3: Il Amministrazione IT vuole eseguire una migrazione in blocco caricando un file .csv. Il file di esempio in questo caso è SPMT.csv.

Load CSV;
$csvItems = import-csv "C:\spmt.csv" -Header c1,c2,c3,c4,c5,c6
ForEach ($item in $csvItems)
{
    Write-Host $item.c1
    Add-SPMTTask -FileShareSource $item.c1 -TargetSiteUrl $item.c4 -TargetList $item.c5 -TargetListRelativePath $item.c6
}

Sono definite due attività di migrazione nel file SPMT.csv.

D:\MigrationTest\Files\Average_1M\c,,,https://SPOSite.sharepoint.com,Documents,Test
C:\work\Powershell\negative,,,https://SPOSite.sharepoint.com/,Documents,DocLibrary_SubfolderName

Frammenti di codice per la migrazione in blocco caricando un file JSON:

#Load JSON:
$jsonItems = Get-Content -Raw -Path  "C:\spmt.json" | ConvertFrom-Json
ForEach ($taskItem in $jsonItems.Tasks)
{
    $jsonString = ConvertTo-Json $taskItem -Depth 100
    Add-SPMTTask -JsonDefinition $jsonString -SharePointSourceCredential $onpremCredential
}

Sono definite tre attività di migrazione nel file SPMT.json.

{
   "Tasks":[
      {
         "SourcePath":"http://On-prem/sites/test",
         "TargetPath":"https://YourSPO.sharepoint.com",
         "Items":{
            "Lists":[
               {
                  "SourceList":"list-01",
                  "TargetList":"list-01"
               }
            ],
            "SubSites":[

            ]
         }
      },
      {
         "SourcePath":"http://On-prem/sites/test",
         "TargetPath":"https://YourSPO.sharepoint.com",
         "Items":{
            "Lists":[
               {
                  "SourceList":"list-02",
                  "TargetList":"list-02"
               }
            ],
            "SubSites":[

            ]
         }
      },
      {
         "SourcePath":"http://On-prem/sites/test",
         "TargetPath":"https://YourSPO.sharepoint.com",
         "Items":{
            "Lists":[
               {
                  "SourceList":"doclib-01",
                  "TargetList":"doclib-01"
               }
            ],
            "SubSites":[

            ]
         }
      }
   ]
}

Esempio 4: visualizzare lo stato della migrazione

Questi esempi mostrano come visualizzare lo stato del progetto di migrazione. Get-SPMTMigration restituisce l'oggetto della sessione corrente. Include lo stato delle attività correnti e le impostazioni a livello di sessione corrente. Lo stato delle attività correnti include:

• Numero di file analizzati.
• Numero di file filtrati.
• Numero di file migrati.
• Numero di file non riusciti.
• Stato della migrazione dell'attività corrente (0 ~ 100).
• Stato dell'attività corrente.
• Messaggi di errore di migrazione, se presenti.

# Start migration in the background
Start-SPMTMigration -NoShow

# Get the object of current migration
$session = Get-SPMTMigration

# Query migration status every 5 seconds until migration is finished
while ($session.Status -ne "Finished")
{
Write-Host $session.Status

    # Query migration progress of each tasks
    Foreach ($taskStatus in $session.StatusOfTasks)
    {
        $taskStatus.MigratingProgressPercentage
}

    Start-Sleep -Seconds 5
}