Carregar conteúdo local no Microsoft Office SharePoint Online utilizando os cmdlets do Windows PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Observação

A ferramenta de migração do SharePoint (SPMT) ajuda a simplificar o processo de migração. O SPMT fornece uma experiência parecida com o assistente para orientá-lo pelo processo de migração dos seus sites de equipe do SharePoint Server ou de seus compartilhamentos de arquivos de rede para o Microsoft 365. Está disponível para todos os usuários do Microsoft 365. > para baixar a ferramenta, acesse: ferramenta de migração do SharePointThe SharePoint Migration Tool (SPMT) helps simplify your migration process. SPMT provides a wizard-like experience to guide you through the process of migrating either your SharePoint Server team sites or your network file shares to Microsoft 365. It is available to all Microsoft 365 users. > To download the tool, go to: SharePoint Migration Tool

Importante

Atualmente, a Ferramenta de Migração do SharePoint não está disponível para usuários do Office 365 operado pela 21Vianet na China.Currently, the SharePoint Migration Tool is not available for users of Office 365 operated by 21Vianet in China.

Este é um guia passo a passo sobre como utilizar os cmdlets do Windows PowerShell de Migração do SharePoint e migrar o conteúdo de um compartilhamento de arquivo local para o Microsoft 365.This is a step-by-step guide about how to use the SharePoint Migration PowerShell cmdlets to migrate content from an on-premises file share to Microsoft 365.

Os cmdlets do Windows PowerShell de Migração do Microsoft Office SharePoint Online foram projetados para mover o conteúdo local de compartilhamentos de arquivos. Exigindo chamadas mínimas de CSOM, ele aproveita o armazenamento temporário de BLOBs do Azure para aumentar a demanda de grandes migrações de conteúdo de dados.SharePoint Migration PowerShell cmdlets are designed to move on-premises content from file shares. Requiring minimal CSOM calls, it leverages Azure temporary BLOB storage to scale to the demand of large migration of data content.

Siga estas etapas para usar o Windows PowerShell de Migração do Microsoft Office SharePoint Online para carregar seus dados locais no SharePoint:Follow these steps to use SharePoint Migration powershell to upload your on-premises data into SharePoint:

Etapa 1: Instalar o Shell de gerenciamento do SharePoint Online.Step 1: Install the SharePoint Online Management Shell.

Etapa 2: Configurar o diretório de trabalho.Step 2: Setup your working directory.

Etapa 3: Determinar seus locais e credenciais.Step 3: Determine your locations and credentials.

Etapa 4: Criar um novo pacote de conteúdo com base em um compartilhamento de arquivos local.Step 4: Create a new content package from an on-premises file share.

Etapa 5: Converter o pacote de conteúdo em seu site de destino.Step 5: Convert the content package for your target site.

Etapa 6: Enviar conteúdo para importar.Step 6: Submit content to import.

(Opcional) Etapa 7: Processando e monitorando sua migração do Microsoft Office SharePoint Online.(Optional) Step 7: Processing and Monitoring your SharePoint Migration.

Pré-requisitosPrerequisites

  • Sistemas operacionais com suporte: Windows 7 Service Pack 1, Windows 8, Windows Server 2008 R2 SP1, Windows Server 2008 Service Pack 2, Windows Server 2012, Windows Server 2012 R2Supported Operating Systems: Windows 7 Service Pack 1, Windows 8, Windows Server 2008 R2 SP1, Windows Server 2008 Service Pack 2, Windows Server 2012, Windows Server 2012 R2

  • Windows PowerShell 4.0Windows PowerShell 4.0

Observação

Permissões: Você deve ser um administrador de conjunto de sites no site de destino.Permissions: You must be a site collection administrator on the site you are targeting.

Antes de começarBefore you begin

Etapa 1: Instalar o Shell de gerenciamento do SharePoint OnlineStep 1: Install the SharePoint Online Management Shell

A primeira etapa é instalar o shell de gerenciamento do SharePoint Online.For the first step, install the SharePoint Online Management shell.

  1. Desinstale todas as versões anteriores do Shell de Gerenciamento do SharePoint Online.Uninstall all previous versions of the SharePoint Online Management Shell.

  2. Instale a partir daqui: Shell de Gerenciamento do SharePoint Online.Install from here: SharePoint Online Management Shell.

  3. Abra o Shell de gerenciamento do SharePoint Online e selecione Executar como Administrador.Open SharePoint Online Management Shell, and select Run as Administrator.

Carregue o conteúdo local no Microsoft Office SharePoint Online usando os cmdlets do Windows PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Etapa 2: Configurar o diretório de trabalhoStep 2: Setup your working directory

Antes de começar o processo de migração, você precisa configurar o diretório de trabalho criando duas pastas vazias. Essas pastas não exigem uma grande quantidade de espaço em disco, pois conterão apenas XML.Before you start the migration process, you need to set up your working directory by creating two empty folders. These folders to not require a lot of disk space as they will only contain XML.

  1. Crie uma pasta de pacote temporária.Create a Temporary package folder.

  2. Crie uma pasta de pacote Final.Create a Final package folder.

Carregue o conteúdo local no Microsoft Office SharePoint Online usando os cmdlets do Windows PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Etapa 3: Determinar seus locais e credenciaisStep 3: Determine your locations and credentials

Nesta etapa, você precisa identificar os locais e credenciais, incluindo o local dos arquivos de origem e de destino e o local da Web.In this step, you must identify your locations and credentials, including the location of your source files, target files and web location.

No computador local, abra o Shell de gerenciamento do SharePoint Online. Execute os seguintes comandos substituindo os valores:On your local computer, open the SharePoint Online Management Shell. Run the following commands substituting your values:

$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'

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

Carregue o conteúdo local no Microsoft Office SharePoint Online usando os cmdlets do Windows PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Etapa 4: Criar um novo pacote de conteúdo com base em um compartilhamento de arquivos localStep 4: Create a new content package from an on-premises file share

Nesta etapa, você criará um novo pacote de migração com base em um compartilhamento de arquivos. Para criar um pacote de conteúdo com base em um compartilhamento de arquivos, o comando New-SPOMigrationPackage lê a lista de conteúdo direcionado pelo caminho de origem e gerará XML para executar a migração.In this step, you will create a new migration package from a file share. To create a content package from a file share, the New-SPOMigrationPackage command reads the list of content targeted by the source path and will generate XML to perform migration.

Os parâmetros a seguir são necessários, a menos que sejam marcados como opcionais:The following parameters are required unless marked optional:

  • SourcefilesPath: aponta para o conteúdo que você deseja migrarSourcefilesPath: points to the content you want to migrate

  • OutputPackagePath: aponta para sua pasta TemporáriaOutputPackagePath: points to your Temporary folder

  • TargetWebUrl: aponta para a Web de destinoTargetWebUrl: point to your destination web

  • TargetDocumentLibraryPath: aponta para a biblioteca de documentos dentro da web.TargetDocumentLibraryPath: point to the document library inside the web.

  • IgnoreHidden: opção para ignorar arquivos ocultos (opcional)IgnoreHidden: option to skip hidden files (optional)

  • ReplaceInvalidCharacters: corrigirá caracteres inválidos quando possível (opcional)ReplaceInvalidCharacters: will fix invalids characters when possible (optional)

Exemplo:Example:

O exemplo a seguir mostra como criar um novo pacote de um compartilhamento de arquivos, ignorando arquivos ocultos e substituindo caracteres sem suporte em um nome de arquivo/pasta.The following example shows how to create a new package from a file share, ignoring hidden files and replacing unsupported characters in a file/folder name.

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

Carregue o conteúdo local no Microsoft Office SharePoint Online usando os cmdlets do Windows PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Etapa 5: Converter o pacote de conteúdo em seu site de destinoStep 5: Convert the content package for your target site

Após criar o pacote de conteúdo, use o comando ConvertTo SPOMigrationTargetedPackage para converter o xml gerado na pasta temporária. Ele salva um novo conjunto de arquivos de metadados de pacote de migração direcionada na pasta de destino. Este é o pacote final.After you have created the content package, use the ConvertTo-SPOMigrationTargetedPackage command to convert the xml generated in your temporary folder. It saves a new set of targeted migration package metadata files to the target directory. This is the final package.

Observação

Suas credenciais de administrador de conjunto de sites de destino são usadas para coletar dados para se conectar ao conjunto de sites de dados.Your target site collection administrator credentials are used to gather data to connect to the data site collection.

Há seis parâmetros necessários a inserir (outros são opcionais):There are six required parameters to enter (others are optional):

  • ParallelImport: instrui a ferramenta para otimizar o desempenho usando threads paralelos.ParallelImport : Instructs the tool to optimize performance by using parallel threads.

  • SourceFiles: aponta para o local do diretório onde existem arquivos de conteúdo de origem do pacote.SourceFiles: Points to the directory location where the package's source content files exist.

  • SourcePackagePath: aponta para sua pasta de pacote Temporário.SourcePackagePath: Points to your Temporary package folder.

  • OutputPackagePath: aponta para sua pasta de pacote final.OutputPackagePath: Points to your final package folder.

  • Credenciais: credencial do Microsoft Office SharePoint Online que possui direitos de administrador no site de destino.Credentials: SharePoint credential that has admin rights to the destination site.

  • TargetWebUrl: aponta para a Web de destino.TargetWebUrl: Points to your destination web.

  • TargetDocumentLibraryPath: caminho para sua biblioteca de destino.TargetDocumentLibraryPath: Path to your destination library.

Exemplo:Example:

Este exemplo mostra como converter um pacote em um de destino pesquisando dados no conjunto de sites de destino. Para melhorar o desempenho de migração do compartilhamento de arquivos, ele usa o parâmetro -ParallelImport.This example shows how to convert a package to a targeted one by looking up data in the target site collection. To boost file share migration performance, it uses the -ParallelImport parameter.

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

Carregue o conteúdo local no Microsoft Office SharePoint Online usando os cmdlets do Windows PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Etapa 6: Enviar conteúdo para importarStep 6: Submit content to import

Nesta etapa, o comando Invoke-SPOMigrationEncryptUploadSubmit cria um novo trabalho de migração no conjunto de sites de destino e retorna um GUID que representa o JobID. Esse comando carrega manifestos e arquivos de origem criptografados para o armazenamento temporário de blobs do Azure por trabalho.In this step, the Invoke-SPOMigrationEncryptUploadSubmit command creates a new migration job in the target site collection, and then returns a GUID representing the JobID. This command uploads encrypted source files, and manifests into temporary Azure blob storage per job.

Há quatro parâmetros necessários a inserir (outros são opcionais):There are four required parameters to enter (others are optional):

  • TargetwebURL: aponta para a Web do destino.TargetwebURL: Points to the web of the destination.

  • SourceFilesPath: aponta para os arquivos a serem importados.SourceFilesPath: Points to the files to import.

  • SourcePackagePath: aponta para o manifesto final dos arquivos a serem importados.SourcePackagePath: Points to the final manifest of the files to import.

  • Credenciais: As credenciais do Microsoft Office SharePoint Online que têm permissão de Administrador de Conjunto de Sites no site de destino.Credentials: The SharePoint credentials that have Site Collection Administrator rights to the destination site.

Exemplo 1:Example 1:

Este exemplo mostra como enviar dados de pacote para criar um novo trabalho de migração.This example shows how to submit package data to create a new migration job.

 $job = Invoke-SPOMigrationEncryptUploadSubmit -SourceFilesPath $sourceFiles -SourcePackagePath $targetPackage -Credentials $cred -TargetWebUrl $targetWeb

Exemplo 2:Example 2:

Este exemplo mostra como enviar dados de pacote para criar novos trabalhos de migração para importação paralela.This example shows how to submit package data to create new migration jobs for parallel import.

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

Para cada trabalho enviado, o cmdlet Invoke retorna estas propriedades como parte de um trabalho:For each submitted job, the Invoke cmdlet returns these properties as part of a job:

  • JobId: ID do trabalho no SPO.JobId: ID of the job in SPO.

  • ReportingQueueUri: Fila do Microsoft Office SharePoint Online Azure que armazena as mensagens de progresso da migração em tempo real.ReportingQueueUri: SharePoint Azure queue that stores the real-time progress messages of the migration.

  • Criptografia: A chave de criptografia e o método usados durante o carregamento do conteúdo para o Azure. Isso é necessário quando você descriptografa as mensagens em fila e importa logs.Encryption: Encryption key and method used during uploading the content to Azure. This is required when you decrypt the queue messages and import logs.

Se estiver usando a sua própria conta de armazenamento do Azure para carregar dados no seu armazenamento, use Set-SPOMigrationPackageAzureSource e Submit-SPOMigrationJob.If you're using your own Azure storage account to upload content into your storage, use Set-SPOMigrationPackageAzureSource and Submit-SPOMigrationJob.

Carregue o conteúdo local no SharePoint usando os cmdlets do PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Importante

Custo:Cost:
Se você optar por usar o Armazenamento do Microsoft Azure, esteja ciente de que poderá incorrer em cobranças de largura de banda.If you choose to use your Azure Storage, be aware that you could incur Bandwidth charges. Estes serão cobrados dependendo do tipo de oferta e tamanho da migração do Azure.Those will be billed depending on your Azure offer type and migration size. Para saber mais sobre os preços gerais, consulte preço da largura de banda.For general prices, refer to bandwidth pricing.

(Opcional) Etapa 7: Processar e monitorar sua migração do SharePoint(Optional) Step 7: Processing and monitoring your SharePoint migration

Após o envio da tarefa, apenas o Azure e o Microsoft Office SharePoint Online estão interagindo para buscar e migrar o conteúdo para o destino. Esse processo é baseado no trabalho de timer, e isto significa que está em uma fila por ordem de chegada. E não impede que outros trabalhos sejam colocados na fila pela mesma pessoa.After the job is submitted, only Azure and SharePoint are interacting to fetch and migrate the content into the destination. This process is timer-job based, which means it's in a queue on a first-come, first-served basis. This does not prevent other jobs from being queued up by the same person.

Se não houver outros trabalhos em execução, haverá uma possibilidade de atraso de um minuto.If there are no other jobs running, there is a potential of a one-minute delay.

Verificando o status do trabalhoChecking job status

Você pode verificar o status do trabalho, exibindo as atualizações em tempo real publicadas na fila da conta de armazenamento do Azure com o EncryptionKey retornado na etapa 6.You can check the status of your job by viewing the real-time updates posted in the Azure storage account queue by using the EncryptionKey returned in step 6.

Exibindo logsViewing logs

Se estiver usando sua própria conta de Armazenamento do Azure, você poderá pesquisar no contêiner de manifesto no Armazenamento do Azure por logs de tudo o que aconteceu. Nesse estágio, é seguro excluir esses contêineres se você não quiser mantê-los como backup no Azure.If you're using your own Azure storage account, you can look into the manifest container in the Azure Storage for logs of everything that happened. At this stage, it is now safe to delete those containers if you don't want to keep them as backup in Azure.

Se houver erros ou avisos, arquivos .err e .wrn são criados no contêiner de manifesto.If there were errors or warnings, .err and .wrn files are created in the manifest container.

Se você estiver usando o armazenamento temporário do Azure criado por Invoke-SPOMigrationEncryptUploadSubmit na Etapa 6, a URL SAS do log de importação poderá ser obtida descriptografando a mensagem da fila do Azure com o valor de "Event" "JobLogFileCreate". Com a URL SAS do log de importação, você pode baixar o arquivo de log e descriptografá-lo com a mesma chave de criptografia conforme retornado na etapa 6.If you're using the temporary Azure storage created by Invoke-SPOMigrationEncryptUploadSubmit in step 6, the import log SAS URL can be obtained by decrypting the Azure queue message with the "Event" value "JobLogFileCreate". With the import log SAS URL, you can download the log file, and decrypt it with the same encryption key as returned in step 6.

Carregue o conteúdo local no Microsoft Office SharePoint Online usando os cmdlets do Windows PowerShellUpload on-premises content to SharePoint using PowerShell cmdlets

Cenários de Scripts para ReutilizaçãoScripting Scenarios for Reuse

Use o script de exemplo a seguir que inclui as etapas, desde determinar os locais e as credenciais até enviar os dados do pacote para criar um novo trabalho de migração.Use the following sample script that includes the steps from determining your locations and credentials, to submitting your package data, to creating a new migration job.

$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

Converter o pacote para um pacote de destino pesquisando dados no conjunto de sites de destinoConvert package to a targeted one by looking up data in target site collection

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

Enviar dados do pacote para criar um novo trabalho de migraçãoSubmit package data to create new migration job

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

Este exemplo mostra como acessar as informações retornadas de um trabalho, que vem na forma de um GUID.This sample shows how to get the returned information of a job, which comes in the form of a GUID.

$job = $jobs[0]
$job.JobId
Guid
----
779c4b3b-ec24-4705-bb58-c38f4329418c

Este exemplo mostra como obter o $job.ReportingQueueURi.AbosoluteUri.This sample shows how to get the $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

Este exemplo mostra como obter a chave de criptografia e o retorno da amostra.This sample shows how to obtain the encryption key and the sample return.

$job.Encryption
EncryptionKey                                       EncryptionMethod
-----------------------                            ------------------
{34, 228, 244, 194...}                              AES256CBC

Importante

Todas as mensagens são criptografadas na fila. Se você quiser ler pela ReportingQueue, será preciso ter o EncryptionKey.All messages are encrypted in the queue. If you want to read from the ReportingQueue, you must have the EncryptionKey.

Práticas Recomendadas e LimitaçõesBest Practices and Limitations

DescriçãoDescription
RecomendaçãoRecommendation
Tamanho do pacotePackage size
10-20 GB10-20 GB
Use a opção -ParallelImport para migração de compartilhamento de arquivos, que divide automaticamente o pacote grande em partes menores.Use -ParallelImport switch for File Share migration which automatically splits the big package into smaller ones.
Tamanho do arquivoFile size
2 GB2 GB
Tamanho de destinoTarget size
O site de destino deve permanecer não acessível aos usuários até que a migração seja concluída.Target site should remain non-accessible to users until migration is complete.
Limites do Microsoft Office SharePoint OnlineSharePoint limits
Microsoft Office SharePoint Online e OneDrive: limites e fronteiras do softwareSharePoint: limites e fronteiras do softwareSharePoint and OneDrive: software boundaries and limitsSharePoint: software boundaries and limits.

Limites do AzureAzure Limits

RecursoResource
Limite/padrãoDefault/Limit
TB por conta de armazenamentoTB per storage account
500 TB500 TB
Tamanho máximo de contêiner de blob único, tabela ou fila.Max size of single blob container, table, or queue.
500 TB500 TB
Número máximo de contêineres de blob, blobs, compartilhamentos de arquivos, tabelas, filas, entidades ou mensagens por conta de armazenamento.Max number of blob containers, blobs, file shares, tables, queues, entities, or messages per storage account.
O único limite é a capacidade de conta de armazenamento de 500 TB.Only limit is the 500 TB storage account capacity.
Taxa de transferência de destino para blob únicoTarget throughput for single blob
Até 60 MB por segundo ou até 500 solicitações por segundo.Up to 60 MB per second, or up to 500 requests per second.

Use os cmdlets do Windows PowerShell para migração do Microsoft Office SharePoint Online e OneDriveUse Windows PowerShell cmdlets for SharePoint and OneDrive Migration