PowerShell utente per automatizzare la migrazione

Il cmdlet di PowerShell è progettato per gestire le attività di migrazione della condivisione file in esecuzione nel servizio Gestione migrazione e scaricare i report di analisi e migrazione.

Fare riferimento a questo collegamento per assicurarsi che il computer soddisfi i requisiti di sistema.

Prima di iniziare

Per avviare la migrazione della condivisione file di Gestione migrazione:

1. Installare gli agenti di Gestione migrazione, quindi connetterli al tenant di destinazione con un account amministratore.
2. Accedere a SharePoint Amministrazione Center come amministratore e passare a Migrazione/Condivisione file.

 Scaricare il file ZIP di PowerShell qui e decomprimere la compilazione in una cartella di lavoro

Usare il cmdlet di PowerShell

Avviare PowerShell come amministratore

Eseguire i comandi seguenti:

> Get-ChildItem -Path "working_folder" -Recurse | Unblock-File

> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force

Chiudere la prima finestra di PowerShell e avviare PowerShell come amministratore

Eseguire i comandi seguenti:

> Import-Module "working_folder\Microsoft.SharePoint.MigrationManager.PowerShell.dll"

Nota

Specificare un percorso di file assoluto nel cmdlet Import-Module.

Connettersi al servizio Gestione migrazione

> Connect-MigrationService

Questo cmdlet si connette al servizio Gestione migrazione. Dopo aver stabilito una connessione, è possibile aggiungere attività di migrazione e avviare la migrazione.

Aggiungere un'attività di migrazione

> Add-MigrationTask

Usare questo cmdlet per creare una nuova attività di migrazione. Dopo la creazione, l'attività viene visualizzata nella pagina Gestione migrazione.

Sono necessari i parametri seguenti:

• TaskName: specifica il nome dell'attività di migrazione.

• SourceUri: definisce il percorso del file di origine.

• TargetSiteUrl: indica l'URL del sito di SharePoint di destinazione.

• TargetListName: specifica il nome dell'elenco di SharePoint di destinazione.

Parametri facoltativi:

• ScheduleStartTime: specifica l'ora in cui l'attività inizia a essere eseguita. Per impostazione predefinita, un'attività viene avviata subito dopo l'aggiunta.

• AgentGroup: Assegnare un gruppo di agenti per eseguire l'attività. Per impostazione predefinita, viene assegnato il gruppo "Predefinito".

• Tag: Assegnare tag all'attività. Per assegnare più tag, vengono usati i punti e virgola per separare i valori del tag.

Messaggio di output:

• "L'attività di migrazione viene creata con l'ID attività taskId" se l'attività viene aggiunta correttamente al servizio di migrazione.

• "Impossibile aggiungere l'attività di migrazione. errorMessage" se si verificano errori del cmdlet.

Per un elenco completo dei parametri supportati, eseguire:

> Get-Help Add-MigrationTask -Full

Ottenere report sulla migrazione

> Get-MigrationReport

Usare questo cmdlet per recuperare i report delle attività di migrazione completate in base ai parametri specificati:

• OutputPath: specifica il percorso della directory in cui vengono salvati i report generati.

• StartTime: filtra le attività di migrazione avviate dopo la data e l'ora specificate.

• EndTime: filtra le attività di migrazione avviate prima della data e dell'ora specificate.

• TaskNameContains: filtra le attività di migrazione i cui nomi contengono la parola chiave specificata.

• Tag: filtra le attività di migrazione il cui tag è uguale al parametro specificato. Se vengono specificati più tag, separati da un punto e virgola (;), devono essere restituite tutte le attività il cui tag è uguale a uno nel parametro tags.

• Stato: filtra le attività di migrazione il cui stato è uguale al parametro specificato. I valori supportati sono Completed e Failed. Per impostazione predefinita, vengono scaricati i report delle attività Completate e Non riuscite .

Se non vengono specificati parametri, per impostazione predefinita il cmdlet scarica tutti i report Completati e Non riusciti .

Messaggio di output:

• "Report scaricato per task taskeId" per ogni attività se il file ZIP del report viene scaricato. E l'ultimo messaggio è una riga di riepilogo "Report di migrazione download completato, controllare la cartella di output: outputPath"

• "Impossibile scaricare il report di migrazione. errorMessage" se si verificano errori del cmdlet.

Per un elenco completo dei parametri supportati, eseguire:

> Get-Help Get-MigrationReport -Full

Ottenere i report di analisi

> Get-ScanReport

Usare questo cmdlet per recuperare i report delle attività di analisi completate in base al parametro specificato

• OutputPath: specifica il percorso della directory in cui vengono salvati i report generati.

• StartTime: filtra le attività di migrazione avviate dopo la data e l'ora specificate.

• EndTime: filtra le attività di migrazione avviate prima della data e dell'ora specificate.

• Tag: filtra le attività di migrazione il cui tag è uguale al parametro specificato. Se vengono specificati più tag, separati da un punto e virgola (;), devono essere restituite tutte le attività il cui tag è uguale a uno nel parametro tags.

• Stato: filtra le attività di migrazione il cui stato è uguale al parametro specificato. I valori supportati sono Pronto, Avviso ed Errore. Per impostazione predefinita, vengono scaricati i report delle attività Pronto per la migrazione, Avviso ed Errore .

Se non vengono specificati parametri, per impostazione predefinita il cmdlet scarica tutti i report Pronto per la migrazione, Avviso ed Errore .

Messaggio di output:

• "Analizza il log scaricato per task taskeid" per ogni attività se il file ZIP del report viene scaricato. E l'ultimo messaggio è una riga di riepilogo "Scan logs download completed, check the output folder: outputPath".

• "Impossibile scaricare il log di analisi. error_message" se si verificano errori del cmdlet.

Per un elenco completo dei parametri supportati, eseguire:

> Get-Help Get-ScanReport -Full