User PowerShell для автоматизации миграции

Командлет PowerShell предназначен для управления задачами миграции файлового ресурса, выполняемыми в службе Migration Manager, а также для скачивания отчетов о проверке и миграции.

Перейдите по этой ссылке , чтобы убедиться, что компьютер соответствует требованиям к системе.

Перед началом работы

Чтобы запустить миграцию общей папки диспетчера миграции, выполните приведенные далее действия.

1. Установите агенты Диспетчера миграции, а затем подключите их к целевому клиенту с помощью учетной записи администратора.
2. Войдите в Центр Администратор SharePoint с правами администратора и перейдите к разделу Миграция и файловый ресурс.

 Скачайте ZIP-файл PowerShell здесь и распакуйте сборку в рабочую папку.

Использование командлета PowerShell

Запуск PowerShell от имени администратора

Выполните следующие команды:

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

> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force

Закройте первое окно PowerShell и запустите PowerShell от имени администратора.

Выполните следующие команды:

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

Примечание.

Укажите абсолютный путь к файлу в командлете Import-Module.

Подключение к службе диспетчера миграции

> Connect-MigrationService

Этот командлет подключается к службе Диспетчера миграции. После установки подключения можно добавить задачи миграции и начать миграцию.

Добавление задачи миграции

> Add-MigrationTask

Используйте этот командлет для создания задачи миграции. После создания задача появится на странице Диспетчер миграции.

Требуются следующие параметры:

• TaskName: указывает имя задачи миграции.

• SourceUri: определяет путь к исходному файлу.

• TargetSiteUrl: указывает URL-адрес целевого сайта SharePoint.

• TargetListName: указывает имя целевого списка SharePoint.

Необязательные параметры:

• ScheduleStartTime: указывает время начала выполнения задачи. По умолчанию задача запускается сразу после ее добавления.

• AgentGroup: Назначьте группу агентов для выполнения задачи. По умолчанию назначается группа "По умолчанию".

• Теги: Назначьте теги задаче. Чтобы назначить несколько тегов, используется точка с запятой для разделения значений тегов.

Выходное сообщение:

• "Задача миграции создается с идентификатором задачи taskId", если задача успешно добавлена в службу миграции.

• "Не удалось добавить задачу миграции. errorMessage", если командлет ошибся.

Чтобы получить полный список поддерживаемых параметров, выполните следующую команду:

> Get-Help Add-MigrationTask -Full

Получение отчетов о миграции

> Get-MigrationReport

Используйте этот командлет для получения отчетов о выполненных задачах миграции на основе указанных параметров:

• OutputPath: указывает путь к каталогу, в котором сохраняются созданные отчеты.

• StartTime: фильтрует задачи миграции, которые были запущены после указанной даты и времени.

• EndTime: фильтрует задачи миграции, начатые до указанной даты и времени.

• TaskNameContains: фильтрует задачи миграции, имена которых содержат указанные ключевое слово.

• Теги: фильтрует задачи миграции, тег которых совпадает с заданным параметром. Если задано больше тегов, разделенных точкой с запятой (;), должны быть возвращены все задачи, тег которых совпадает с тегом в параметре tags.

• Состояние: фильтрует задачи миграции, состояние которых совпадает с заданным параметром. Поддерживаемые значения: Completed и Failed. По умолчанию скачиваются отчеты о завершенных и неудачных задачах.

Если параметры не указаны, командлет по умолчанию загружает все отчеты Завершено и Сбой .

Выходное сообщение:

• "Отчет скачан для taskeId" для каждой задачи, если zip-файл отчета скачан. И последним сообщением является сводная строка "Отчеты о миграции скачивание завершено, проверка выходной папке: outputPath"

• "Не удалось скачать отчет о миграции. errorMessage", если командлет ошибся.

Чтобы получить полный список поддерживаемых параметров, выполните следующую команду:

> Get-Help Get-MigrationReport -Full

Получение отчетов о проверке

> Get-ScanReport

Используйте этот командлет для получения отчетов о выполненных задачах проверки на основе указанного параметра.

• OutputPath: указывает путь к каталогу, в котором сохраняются созданные отчеты.

• StartTime: фильтрует задачи миграции, которые были запущены после указанной даты и времени.

• EndTime: фильтрует задачи миграции, начатые до указанной даты и времени.

• Теги: фильтрует задачи миграции, тег которых совпадает с заданным параметром. Если задано больше тегов, разделенных точкой с запятой (;), должны быть возвращены все задачи, тег которых совпадает с тегом в параметре tags.

• Состояние: фильтрует задачи миграции, состояние которых совпадает с заданным параметром. Поддерживаемые значения: Ready, Warning и Error. По умолчанию скачиваются отчеты о задачах "Готово к миграции", "Предупреждение" и "Ошибка".

Если параметры не указаны, командлет по умолчанию загружает все отчеты о готовности к миграции, предупреждениях и ошибках .

Выходное сообщение:

• "Сканировать журнал, скачанный для задачи задачи" для каждой задачи, если zip-файл отчета скачан. И последним сообщением является сводная строка "Сканирование журналов, скачивание завершено, проверка выходную папку: outputPath".

• "Не удалось скачать журнал сканирования. error_message" в случае возникновения ошибок командлета.

Чтобы получить полный список поддерживаемых параметров, выполните следующую команду:

> Get-Help Get-ScanReport -Full