Utilizador do PowerShell para automatizar a migração

O cmdlet do PowerShell foi concebido para gerir tarefas de migração de partilha de ficheiros em execução no serviço Gestor de Migração e transferir relatórios de análise e migração.

Veja esta ligação para se certificar de que o computador cumpre os requisitos de sistema.

Antes de começar

Para iniciar a migração da partilha de ficheiros do Gestor de Migração:

1. Instale os Agentes do Gestor de Migração e, em seguida, ligue-os ao inquilino de destino com uma conta de administrador.
2. Inicie sessão no Centro de Administração do SharePoint como administrador e navegue para Migração/Partilha de Ficheiros.

 Transfira o ficheiro zip do PowerShell aqui e deszipe a criação numa pasta de trabalho

Utilizar o cmdlet do PowerShell

Iniciar o PowerShell como Administrador

Execute os seguintes comandos:

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

> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force

Feche a primeira janela do PowerShell e inicie o PowerShell como Administrador

Execute os seguintes comandos:

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

Ligar ao serviço Gestor de Migração

> Connect-MigrationService

Este cmdlet liga-se ao serviço Gestor de Migração. Depois de estabelecer uma ligação, pode adicionar tarefas de migração e iniciar a migração.

Adicionar uma tarefa de migração

> Add-MigrationTask

Utilize este cmdlet para criar uma nova tarefa de migração. Após a criação, a tarefa é apresentada na página Gestor de Migração.

São necessários os seguintes parâmetros:

• TaskName: especifica o nome da tarefa de migração.

• SourceUri: define o caminho do ficheiro de origem.

• TargetSiteUrl: indica o URL do site sharePoint de destino.

• TargetListName: especifica o nome da lista do SharePoint de destino.

Parâmetros opcionais:

• ScheduleStartTime: especifica a hora em que a tarefa começa a ser executada. Por predefinição, uma tarefa é iniciada logo após adicioná-la.

• AgentGroup: Atribua um grupo de agentes para executar a tarefa. Por predefinição, o grupo "Predefinição" está atribuído.

• Etiquetas: Atribua etiquetas à tarefa. Para atribuir mais do que uma etiqueta, é utilizado ponto e vírgula para separar os valores das etiquetas.

Mensagem de saída:

• "A tarefa de migração é criada com taskId do ID da tarefa" se a tarefa for adicionada com êxito ao serviço de migração.

• "Falha ao adicionar a tarefa de migração. errorMessage" se o cmdlet estiver com erros.

Para obter uma lista completa dos parâmetros suportados, execute:

> Get-Help Add-MigrationTask -Full

Obter relatórios de migração

> Get-MigrationReport

Utilize este cmdlet para obter relatórios de tarefas de migração concluídas com base nos parâmetros especificados:

• OutputPath: especifica o caminho do diretório onde os relatórios gerados são guardados.

• StartTime: filtra as tarefas de migração que foram iniciadas após a data e hora especificadas.

• EndTime: filtra as tarefas de migração iniciadas antes da data e hora especificadas.

• TaskNameContains: filtra tarefas de migração cujos nomes contêm o palavra-chave especificado.

• Etiquetas: filtra tarefas de migração cuja etiqueta é igual ao parâmetro especificado. Se forem fornecidas mais do que etiquetas, separadas por um ponto e vírgula (;), todas as tarefas cuja etiqueta é igual a uma no parâmetro de etiquetas devem ser devolvidas.

• Estado: filtra tarefas de migração cujo status é igual ao parâmetro especificado. Os valores suportados são Concluídos e Falhados. Por predefinição, os relatórios de tarefas Concluídas e Falhadas são transferidos.

Se não forem especificados parâmetros, o cmdlet é predefinido para transferir todos os relatórios Concluídos e Com Falhas .

Mensagem de saída:

• "Relatório transferido para taskeId de tarefa" para cada tarefa se o ficheiro zip do relatório for transferido. E a última mensagem é uma linha de resumo "Relatórios de migração a transferir concluídos, marcar a pasta de saída: outputPath"

• "Falha ao transferir o relatório de migração. errorMessage" se o cmdlet estiver com erros.

Para obter uma lista completa dos parâmetros suportados, execute:

> Get-Help Get-MigrationReport -Full

Obter relatórios de análise

> Get-ScanReport

Utilize este cmdlet para obter relatórios de tarefas de análise concluídas com base no parâmetro especificado

• OutputPath: especifica o caminho do diretório onde os relatórios gerados são guardados.

• StartTime: filtra as tarefas de migração que foram iniciadas após a data e hora especificadas.

• EndTime: filtra as tarefas de migração iniciadas antes da data e hora especificadas.

• Etiquetas: filtra tarefas de migração cuja etiqueta é igual ao parâmetro especificado. Se forem fornecidas mais do que etiquetas, separadas por um ponto e vírgula (;), todas as tarefas cuja etiqueta é igual a uma no parâmetro de etiquetas devem ser devolvidas.

• Estado: filtra tarefas de migração cujo status é igual ao parâmetro especificado. Os valores suportados são Ready( Pronto), Warning (Aviso) e Error (Erro). Por predefinição, os relatórios das tarefas Pronto para migrar, Aviso e Erro são transferidos.

Se não forem especificados parâmetros, o cmdlet é predefinido para transferir todos os relatórios Pronto para migrar, Aviso e Erro .

Mensagem de saída:

• "Registo de análise transferido para taskeid de tarefa" para cada tarefa se o ficheiro zip do relatório for transferido. E a última mensagem é uma linha de resumo "A transferência dos registos de análise foi concluída, marcar a pasta de saída: outputPath".

• "Falha ao transferir o registo de análise. error_message" se o cmdlet estiver com erros.

Para obter uma lista completa dos parâmetros suportados, execute:

> Get-Help Get-ScanReport -Full