Carregar o conteúdo local para o SharePoint Online

Este é um guia passo a passo sobre como usar os cmdlets do PowerShell de migração online do SharePoint Online para migrar o conteúdo de um compartilhamento de arquivos local para o Office 365.

Os cmdlets do PowerShell de migração online do SharePoint Online foram projetados para mover conteúdo local de compartilhamentos de arquivos. Precisando de uma quantidade mínima de chamadas CSOM, eles utilizam o armazenamento de blobs temporário do Azure para se ajustar à demanda de grande migração de conteúdo de dados.

Estas são as etapas para usar o PowerShell de Migração de SPO para carregar os seus dados locais para o SharePoint Online:

Etapa 1: Instalar o Shell de gerenciamento do SharePoint Online.

Etapa 2: Configurar o diretório de trabalho

Etapa 3: Determinar seus locais e credenciais

Etapa 4: Criar um novo pacote de conteúdo com base em um compartilhamento de arquivos local

Etapa 5: Converter o pacote de conteúdo em seu site de destino

Etapa 6: Enviar conteúdo para importar

Etapa 7: Processar e monitorar a migração SPO (opcional)

Pré-requisitos

  • 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 R2

  • Windows PowerShell 4.0

Observação : Permissões: Você deve ser um administrador de conjunto de sites no site de destino.

Antes de começar

Etapa 1: Instalar o Shell de gerenciamento do SharePoint Online

A primeira etapa é instalar o shell de gerenciamento do SharePoint Online.

  1. Desinstale todas as versões anteriores do Shell de Gerenciamento do SharePoint Online.

  2. Instale a partir daqui: Shell de Gerenciamento do SharePoint Online.

  3. Abra o Shell de gerenciamento do SharePoint Online e selecione Executar como Administrador.

Voltar ao início

Etapa 2: Configurar o diretório de trabalho

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.

  1. Crie uma pasta de pacote temporária.

  2. Crie uma pasta de pacote Final.

Voltar ao início

Etapa 3: Determinar seus locais e credenciais

Nesta etapa, você precisa identificar os locais e credenciais, incluindo o local dos arquivos de origem e de destino e o local da Web.

No computador local, abra o Shell de gerenciamento do SharePoint Online. Execute os seguintes comandos substituindo os valores.

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

Voltar ao início

Etapa 4: Criar um novo pacote de conteúdo com base em um compartilhamento de arquivos local

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.

Os parâmetros a seguir são necessários, a menos que sejam marcados como opcionais:

  • SourcefilesPath: aponta para o conteúdo que você deseja migrar

  • OutputPackagePath: aponta para a sua pasta temporária

  • TargetWebUrl: aponta para a Web de destino

  • TargetDocumentLibraryPath: aponta para a biblioteca de documentos dentro da web.

  • IgnoreHidden: opção para ignorar arquivos ocultos (opcional)

  • ReplaceInvalidCharacters: corrigirá caracteres inválidos quando possível (opcional)

Exemplo:

Este exemplo 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.

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

Voltar ao início

Etapa 5: Converter o pacote de conteúdo em seu site de destino

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.

Observação : Suas credenciais de administrador de conjunto de sites de destino são usados para coletar dados para se conectar ao conjunto de dados.

Há seis parâmetros necessários a inserir (outros são opcionais)

  • ParallelImport: informa a ferramenta para otimizar o desempenho usando threads paralelos.

  • SourceFiles: aponta para o local do diretório onde existem arquivos de conteúdo de origem do pacote

  • SourcePackagePath: aponta para sua pasta de pacote temporária

  • OutputPackagePath: aponta para sua pasta de pacote final

  • Credenciais: Credenciais SPO com direitos de administrador para o site de destino

  • TargetWebUrl: aponta para a Web de destino

  • TargetDocumentLibraryPath: o caminho para sua biblioteca de destino

Exemplo:

Este exemplo mostra como converter um pacote em um de destino pesquisando dados no conjunto de sites de destino. Ele usa o parâmetro –ParallelImport para melhorar o desempenho de migração do compartilhamento de arquivos.

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

Voltar ao início

Etapa 6: Enviar conteúdo para importar

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 carregará manifestos e arquivos de origem criptografados para o armazenamento temporário de blobs do Azure por trabalho.

Há quatro parâmetros necessários a inserir (outros são opcionais):

  • TargetwebURL: Aponta para a Web do destino

  • SourceFilesPath: Aponta para os arquivos a serem importados

  • SourcePackagePath: Aponta para o manifesto final dos arquivos a serem importados

  • Credenciais: as credenciais do SharePoint Online que têm direitos de Administrador de Conjunto de Sites para o site de destino

Exemplo 1:

Este exemplo mostra como enviar dados de pacote para criar um novo trabalho de migração.

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

Exemplo 2:

Este exemplo mostra como enviar dados de pacote para criar novos trabalhos de migração para importação paralela.

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

  • JobId: a ID do trabalho no SPO

  • ReportingQueueUri: a fila do SPO Azure que armazena as mensagens de progresso em tempo real da migração.

  • 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.

Se estiver usando sua própria conta de armazenamento do Azure, use Set-SPOMigrationPackageAzureSource e Submit-SPOMigrationJob para carregar conteúdo no armazenamento

Voltar ao início

(Opcional) Etapa 7: Processar e monitorar sua migração SPO

Depois que o trabalho é enviado, apenas o Azure e o SPO interagem para buscar e migrar o conteúdo para o destino. Esse processo é baseado no trabalho do temporizador, o que significa que é uma fila por ordem de chegada. Isso não impede que a mesma pessoa coloque outros trabalhos na fila.

Há uma possibilidade de um atraso de um minuto se não existirem outros trabalhos em execução.

Verificar o status de trabalho

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 Encryption.EncryptionKey retornado na etapa 6.

Exibindo 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.

Se houver erros ou avisos, arquivos .err e .wrn serão criados no contêiner de manifesto.

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.

Voltar ao início

Cenários de scripts para reutilização

A seguir está um script de exemplo que você pode usar e que inclui as etapas completas, desde determinar os locais e as credenciais até enviar os dados do pacote para criar um novo trabalho de migração.

    
    

$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 um pacote em um de destino pesquisando dados no conjunto de sites de destino

$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ção

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

$job = $jobs[0]

$job.JobId

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

Este exemplo mostra como obter o $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 demonstra como obter a chave de criptografia e o retorno da amostra.

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

Práticas recomendadas e limitações

Descrição

Recomendação

Tamanho do pacote

10-20 GB

Use a opção –ParallelImport para migração de compartilhamento de arquivos, que dividirá automaticamente o pacote grandes em partes menores.

Tamanho do arquivo

2 GB

Tamanho de destino

O site de destino deve permanecer não acessível aos usuários até que a migração seja concluída

Limites do SharePoint Online

SharePoint Online e OneDrive for Business: delimitações e limites do softwareSharePoint Online: delimitações e limites do software

Limites do Azure

Recurso

Limite/padrão

TB por conta de armazenamento

500 TB

Tamanho máximo de um único contêiner de blobs, tabela ou fila

500 TB

Número máximo de contêineres de blob, blobs, compartilhamentos de arquivos, tabelas, filas, entidades ou mensagens por conta de armazenamento

O único limite é a capacidade de conta de armazenamento de 500 TB

Taxa de transferência de destino para único blob

Até 60 MB por segundo ou até 500 solicitações por segundo

Tópicos Relacionados

Usar cmdlets do Windows PowerShell cmdlets para migração do SharePoint Online e do OneDrive

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×