Добавление локального контента в SharePoint Online

В этой статье представлены пошаговые инструкции по использованию командлетов PowerShell для перехода на SharePoint Online, т. е. для переноса содержимого из локальной общей папки в Office 365.

Командлеты оболочки PowerShell для перехода на SharePoint Online предназначены для перемещения локального содержимого из общих папок. Они позволяют свести использование CSOM к минимуму и эффективно задействовать временное хранилище BLOB-объектов Azure для масштабирования в зависимости от объемов переносимых данных.

Ниже описана процедура, с помощью которой можно отправить локальные данные в SharePoint Online через командную консоль перехода на SharePoint Online.

Шаг 1. Установка командной консоли SharePoint Online

Шаг 2. Настройка рабочего каталога

Шаг 3. Определение расположений и учетных данных

Шаг 4. Создание нового пакета содержимого локальной общей папки

Шаг 5. Преобразование пакета содержимого для конечного сайта

Шаг 6. Передача содержимого для импорта

Шаг 7. Выполнение и отслеживание перехода на SharePoint Online (необязательно)

Предварительные требования

  • Поддерживаемые операционные системы: Windows 7 с пакетом обновления 1 (SP1), Windows 8, Windows Server 2008 R2 с пакетом обновления 1 (SP1), Windows Server 2008 с пакетом обновления 2 (SP2), Windows Server 2012, Windows Server 2012 R2

  • Windows PowerShell 4.0

Примечание : Разрешения. На конечном сайте у вас должны быть права администратора семейства веб-сайтов.

Подготовка

Шаг 1. Установка командной консоли SharePoint Online

Первым этапом является установка командной консоли SharePoint Online.

  1. Удалите все предыдущие версии командной консоли SharePoint Online.

  2. Загрузите пакет установщика по следующей ссылке: Командная консоль SharePoint Online. Установите приложение.

  3. Запустите командную консоль SharePoint Online и выберите пункт Запуск от имени администратора.

К началу

Шаг 2. Настройка рабочего каталога

Прежде чем начинать переход, необходимо настроить рабочий каталог, создав две пустых папки. Они не займут много места на диске: в них будут храниться только XML-файлы.

  1. Создайте папку для временного пакета.

  2. Создайте папку для окончательного пакета.

К началу

Шаг 3. Определение расположений и учетных данных

На этом этапе определяются расположения и учетные данные, в том числе место хранения исходных и целевых файлов, а также веб-адрес.

На локальном компьютере откройте командную консоль SharePoint Online. Выполните указанные ниже команды, подставив необходимые значения.

$cred = (Get-Credential admin@contoso.com)

$sourceFiles = '\\fileshare\users\charles'

$sourcePackage = 'C:\migration\CharlesDocumentsPackage_source'

$targetPackage = 'C:\migration\CharlesDocumentsPackage_target'

$targetWeb = 'https://contoso-my.sharepoint.com/personal/charles_contoso_com'

$targetDocLib = 'Documents’

К началу

Шаг 4. Создание нового пакета содержимого локальной общей папки

На этом шаге создается пакет миграции из общей папки. Для создания пакета содержимого общей папки используется команда New-SPOMigrationPackage. С ее помощью считывается список необходимого контента в исходной папке, а затем создается XML-файл для переноса.

Следующие параметры обязательны, если не указано иное:

  • SourcefilesPath: путь к переносимому содержимому.

  • OutputPackagePath: путь к временной папке.

  • TargetWebUrl: путь к конечному сайту.

  • TargetDocumentLibraryPath: путь к библиотеке документов на сайте.

  • IgnoreHidden: позволяет пропустить скрытые файлы (необязательно)

  • ReplaceInvalidCharacters: по возможности исправляет недопустимые символы (необязательно)

Пример

В этом примере показано создание нового пакета миграции из общей папки с игнорированием скрытых файлов и заменой неподдерживаемых знаков в именах файлов и папок.

New-SPOMigrationPackage -SourceFilesPath $sourceFiles -OutputPackagePath $sourcePackage -TargetWebUrl $targetWeb -TargetDocumentLibraryPath $targetDocLib -IgnoreHidden –ReplaceInvalidCharacters

К началу

Шаг 5. Преобразование пакета содержимого для конечного сайта

После создания пакета содержимого вызывается команда ConvertTo SPOMigrationTargetedPackage. С ее помощью преобразуется XML-файл, созданный в вашей временной папке. В целевой каталог сохраняется новый набор файлов с метаданными целевого пакета миграции. Это окончательный пакет.

Примечание : Учетные данные администратора конечного семейства веб-сайтов используются для сбора данных, необходимых для подключения к семейству веб-сайтов.

Следует указать шесть обязательных параметров (остальные используются при необходимости).

  • ParallelImport: оптимизация производительности с помощью параллельных потоков.

  • SourceFiles: путь к каталогу с исходными файлами пакета.

  • SourcePackagePath: путь к папке временного пакета.

  • OutputPackagePath: путь к папке окончательного пакета.

  • Credentials: учетные данные SharePoint Online с правами администратора на конечном сайте.

  • TargetWebUrl: путь к конечному сайту.

  • TargetDocumentLibraryPath: путь к целевой библиотеке.

Пример

В этом примере показано преобразование пакета в целевой путем поиска данных в конечном семействе веб-сайтов. Для ускорения переноса общей папки используется параметр ParallelImport.

$finalPackages = ConvertTo-SPOMigrationTargetedPackage -ParallelImport -SourceFilesPath $sourceFiles -SourcePackagePath $sourcePackage -OutputPackagePath $targetPackage -Credentials $cred -TargetWebUrl $targetWeb -TargetDocumentLibraryPath $targetDocLib

К началу

Шаг 6. Передача содержимого для импорта

На этом шаге используется команда Invoke-SPOMigrationEncryptUploadSubmit, которая создает задание переноса в конечном семействе веб-сайтов, а затем возвращает GUID, представляющий собой идентификатор задания. Эта команда отправляет зашифрованные исходные файлы и манифесты во временное хранилище BLOB-объектов Azure для задания.

Следует указать четыре обязательных параметра (остальные используются при необходимости):

  • TargetwebURL: URL-адрес конечного веб-сайта

  • SourceFilesPath: путь к импортируемым файлам

  • SourcePackagePath: путь к окончательному манифесту импортируемых файлов

  • Credentials: учетные данные SharePoint Online с правами администратора семейства веб-сайтов на конечном сайте.

Пример 1

В этом примере показана отправка данных пакета для создания нового задания переноса.

$job = Invoke-SPOMigrationEncryptUploadSubmit -SourceFilesPath $sourceFiles -SourcePackagePath $spoPackagePath -Credentials $cred -TargetWebUrl $targetWebUrl

Пример 2

В этом примере показана отправка данных пакета с целью создания новых заданий переноса для параллельного импорта.

$jobs = $finalPackages | % {Invoke-SPOMigrationEncryptUploadSubmit -SourceFilesPath $_.FilesDirectory.FullName -SourcePackagePath $_.PackageDirectory.FullName -Credentials $cred -TargetWebUrl $targetWeb}

Для каждого отправленного задания командлет Invoke возвращает указанные ниже свойства.

  • JobId: идентификатор задания в SPO.

  • ReportingQueueUri: очередь SPO Azure, в которую в режиме реального времени сохраняются сообщения о ходе миграции.

  • Encryption: ключ и способ шифрования, использованные при отправке содержимого в Azure. Эти данные нужны для расшифровки сообщений очереди и журналов импорта.

Если вы используете учетную запись собственного хранилища Azure, выполните командлеты Set-SPOMigrationPackageAzureSource и Submit-SPOMigrationJob для отправки содержимого в свое хранилище.

К началу

Шаг 7 (необязательно). Выполнение и отслеживание перехода на SharePoint Online

После отправки задания взаимодействуют только системы Azure и SharePoint Online, извлекая и перенося содержимое в целевой каталог. Этот процесс основан на задании таймера, т. е. это очередь, задачи в которой обрабатываются в порядке поступления. Это не мешает тому же самому пользователю ставить в очередь другие задания.

Если другие задания не выполняются, может возникнуть задержка на 1 минуту.

Проверка состояния задания

Вы можете уточнить состояние задания в очереди учетной записи службы хранилища Azure, обновляемой в режиме реального времени. Используйте для этого ключ Encryption.EncryptionKey, возвращенный на шаге 6.

Просмотр журналов

Если вы используете учетную запись собственного хранилища Azure, журналы со всеми событиями можно найти в контейнере манифеста в службе хранилища Azure. На этом этапе можно безопасно удалить эти контейнеры, если вы не хотите хранить их в Azure в качестве резервной копии.

В случае ошибок или предупреждений в контейнере манифеста создаются ERR- и WRN-файлы.

Если вы используете временное хранилище Azure, созданное с помощью команды Invoke-SPOMigrationEncryptUploadSubmit на шаге 6, URL-адрес SAS журнала импорта можно получить путем расшифровки сообщения очереди Azure, параметр Event которого имеет значение JobLogFileCreate. С помощью URL-адреса SAS журнала импорта можно скачать файл журнала и расшифровать его, используя ключ шифрования, возвращенный на шаге 6.

К началу

Сценарии для повторного использования

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

    
    

$userName = "admin@contoso.onmicrosoft.com"

$sourceFiles = "d:\data\documents"

$packagePath = "d:\data\documentPackage"

$spoPackagePath = "d:\data\documentPackageForSPO"

$targetWebUrl = "https://contoso.sharepoint.com/sites/finance"

$targetLibrary = "Documents"

$cred = Get-Credential $userName

New-SPOMigrationPackage -SourceFilesPath $sourceFiles -OutputPackagePath $packagePath -TargetWebUrl $targetWebUrl -TargetDocumentLibraryPath $targetLibrary -IgnoreHidden -ReplaceInvalidCharacters

# Преобразование пакета в целевой путем поиска данных в конечном семействе веб-сайтов.

$finalPackages = ConvertTo-SPOMigrationTargetedPackage -SourceFilesPath $sourceFiles -SourcePackagePath $packagePath -OutputPackagePath $spoPackagePath -TargetWebUrl $targetWebUrl -TargetDocumentLibraryPath $targetLibrary -Credentials $cred

# Отправка данных пакета для создания задания переноса.

$job = Invoke-SPOMigrationEncryptUploadSubmit -SourceFilesPath $sourceFiles -SourcePackagePath $spoPackagePath -Credentials $cred -TargetWebUrl $targetWebUrl

В этом примере показано, как можно в форме GUID получить возвращенные сведения о задаче.

$job = $jobs[0]

$job.JobId

Guid
----
779c4b3b-ec24-4705-bb58-c38f4329418c

В этом примере показано получение параметра $job.ReportingQueueURi.AbosoluteUri.

# To obtain the $job.ReportingQueueUri.AbsoluteUri

https://spodm1bn1m013pr.queue.core.windows.net/953pq20161005-f84b9e51038b4139a179f973e95a6d6f?sv=2014-02-14&sig=TgoUcrMk1Pz8VzkswQa7owD1n8TvLmCQFZGzyV7WV8M%3D&st=2016-10-04T07%3A00%3A00Z&se=2016-10-26T07%3A00%3A00Z&sp=rap

В этом примере показано получение ключа шифрования и приведены возвращаемые сведения.

$job.Encryption
EncryptionKey                                       EncryptionMethod

-------------                                             ----------------

{34, 228, 244, 194...}                              AES256CBC

Важно : Все сообщения шифруются в очереди. Для чтения ReportingQueue потребуется ключ шифрования EncryptionKey.

Рекомендации и ограничения

Описание

Рекомендации

Размер пакета

10–20 ГБ

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

Размер файла

2 ГБ

Конечный размер

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

Ограничения SharePoint Online

SharePoint Online и OneDrive для бизнеса: ограничения, связанные с программным обеспечениемSharePoint Online: ограничения, связанные с программным обеспечением

Ограничения Azure

Ресурс

Значение по умолчанию/ограничение

Объем на учетную запись службы хранилища

500 ТБ

Максимальный размер одного контейнера BLOB-объектов, таблицы или очереди

500 ТБ

Максимальное число контейнеров BLOB-объектов, BLOB-объектов, общих папок, таблиц, очередей, сущностей или сообщений на учетную запись службы хранилища

Единственное ограничение — размер учетной записи службы хранилища не должен превышать 500 ТБ

Целевая пропускная способность для одного BLOB-объекта

До 60 МБ/с или до 500 запросов в секунду

См. также:

Миграция SharePoint Online и OneDrive с помощью командлетов Windows PowerShell

Совершенствование навыков
Перейти к обучению
Первоочередный доступ к новым возможностям
Присоединиться к программе предварительной оценки Office

Были ли сведения полезными?

Спасибо за ваш отзыв!

Благодарим за отзыв! Возможно, будет полезно связать вас с одним из наших специалистов службы поддержки Office.

×