PowerShell do usuário para automatizar a migração

O cmdlet do PowerShell foi projetado para gerenciar tarefas de migração de compartilhamento de arquivos em execução no serviço Gerenciador de Migração e baixar relatórios de verificação e migração.

Consulte este link para verificar se o computador atende aos requisitos do sistema.

Antes de começar

Para iniciar a migração de compartilhamento de arquivos do Gerenciador de Migração:

1. Instale os Agentes do Gerenciador de Migração e conecte-os ao locatário de destino com uma conta de administrador.
2. Entre no Centro de Administração do SharePoint como administrador e navegue até Migração/Compartilhamento de Arquivos.

 Baixe o arquivo zip do PowerShell aqui e descompacte a compilação em uma pasta de trabalho

Usar o cmdlet do PowerShell

Abra 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"

Conectar-se ao serviço do Gerenciador de Migração

> Connect-MigrationService

Esse cmdlet se conecta ao serviço do Gerenciador de Migração. Depois que uma conexão for estabelecida, você poderá adicionar tarefas de migração e iniciar a migração.

Adicionar uma tarefa de migração

> Add-MigrationTask

Use este cmdlet para criar uma nova tarefa de migração. Após a criação, a tarefa aparece na página do Gerenciador de Migração.

Os seguintes parâmetros são necessários:

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

• SourceUri: define o caminho do arquivo de origem.

• TargetSiteUrl: indica a URL de destino do site do SharePoint.

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

Parâmetros opcionais:

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

• AgentGroup: Atribua um grupo de agentes para executar a tarefa. Por padrão, o grupo "Padrão" é atribuído.

• Marcações: Atribua marcas à tarefa. Para atribuir mais de uma marca, ponto-e-vírgula é usado para separar os valores da marca.

Mensagem de saída:

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

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

Para obter uma lista completa de parâmetros com suporte, execute:

> Get-Help Add-MigrationTask -Full

Obter relatórios de migração

> Get-MigrationReport

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

• OutputPath: especifica o caminho do diretório em que os relatórios gerados são salvos.

• StartTime: Filtra tarefas de migração 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 a palavra-chave especificada.

• Tags: Filtra tarefas de migração cuja marca é a mesma que o parâmetro fornecido. Se mais de marcas forem fornecidas, separadas por um ponto e vírgula (;), todas as tarefas cuja marca seja igual a uma no parâmetro marcas deverão ser retornadas.

• Status: Filtra tarefas de migração cujo status é igual ao parâmetro fornecido. Os valores com suporte são Concluído e Reprovado. Por padrão, os relatórios de tarefas concluídas e com falha são baixados.

Se nenhum parâmetro for especificado, o cmdlet usará como padrão baixar todos os relatórios concluídos e com falha .

Mensagem de saída:

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

• "Falha ao baixar o relatório de migração. errorMessage" se o cmdlet apresentar erros.

Para obter uma lista completa de parâmetros com suporte, execute:

> Get-Help Get-MigrationReport -Full

Obtenha relatórios de verificação

> Get-ScanReport

Use este cmdlet para recuperar relatórios de tarefas de verificação concluídas com base no parâmetro especificado

• OutputPath: especifica o caminho do diretório em que os relatórios gerados são salvos.

• StartTime: Filtra tarefas de migração iniciadas após a data e hora especificadas.

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

• Tags: Filtra tarefas de migração cuja marca é a mesma que o parâmetro fornecido. Se mais de marcas forem fornecidas, separadas por um ponto e vírgula (;), todas as tarefas cuja marca seja igual a uma no parâmetro marcas deverão ser retornadas.

• Status: Filtra tarefas de migração cujo status é igual ao parâmetro fornecido. Os valores com suporte são Ready, Warning e Error. Por padrão, os relatórios de tarefas Pronto para migrar, Aviso e Erro são baixados.

Se nenhum parâmetro for especificado, o cmdlet usará como padrão o download de todos os relatórios Pronto para migrar, Aviso e Erro .

Mensagem de saída:

• "Verificar log baixado para tarefa taskeid" para cada tarefa se o arquivo zip do relatório for baixado. E a última mensagem é uma linha de resumo "Verificar download de logs concluído, Marque a pasta de saída: outputPath".

• "Falha ao baixar o log de verificação. error_message" se o cmdlet apresentar erro.

Para obter uma lista completa de parâmetros com suporte, execute:

> Get-Help Get-ScanReport -Full