Import-SPWeb

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

Importa um aplicativo Web, uma lista ou uma biblioteca.

Syntax

Import-SPWeb
      [-Identity] <SPWebPipeBind>
      -Path <String>
      [-ActivateSolutions]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-HaltOnError]
      [-HaltOnWarning]
      [-IncludeUserCustomAction <SPIncludeUserCustomAction>]
      [-IncludeUserSecurity]
      [-NoFileCompression]
      [-NoLogFile]
      [-UpdateVersions <SPUpdateVersions>]
      [-WhatIf]
      [-PreserveDeletedUserMetadataReferences]
      [<CommonParameters>]

Description

O cmdlet Import-SPWeb importa um aplicativo Web, uma lista ou uma biblioteca. A capacidade de importar de uma biblioteca é um novo recurso em Produtos do SharePoint.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

---------------------EXEMPLO----------------------

Import-SPWeb https://site -Path export.cmp -UpdateVersions Overwrite

Este exemplo importa o conteúdo de export.cmp para um site em https://site, substituindo o conteúdo do site com versão pelo conteúdo do arquivo export.cmp.

Parâmetros

-ActivateSolutions

Especifica se as soluções de usuário serão ativadas durante a importação.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Force

Esse parâmetro não tem nenhuma função neste cmdlet.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-HaltOnError

Interrompe o processo de exportação quando ocorre um erro.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-HaltOnWarning

Interrompe o processo de exportação quando ocorre um aviso.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

Especifica a URL ou o GUID da Web no qual a importação será feita.

O tipo deve ser uma URL, um GUID ou um objeto válido; por exemplo, uma URL no formato https://server_name ou um GUID no formato 1234-4567-5678a.

Type:	SPWebPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-IncludeUserCustomAction

Especifica se as Ações Personalizadas de Usuário serão incluídas durante a importação.

Os valores válidos são:

Todos, Nenhum

Type:	SPIncludeUserCustomAction
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-IncludeUserSecurity

Preserva as configurações de segurança do usuário.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-NoFileCompression

Habilita ou desabilita a compactação de arquivo no pacote de exportação. O pacote de exportação é armazenado na pasta especificada pelo parâmetro Path ou pelo parâmetro Identity. É recomendável que você esse parâmetro por razões de desempenho. Se a compactação estiver habilitada, o processo de exportação pode apresentar uma melhora de aproximadamente 30%.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-NoLogFile

Suprime a geração de uma arquivo de log de exportação. Se esse parâmetro estiver ausente, o cmdlet Import-SPWeb gerará um arquivo de log de exportação no mesmo local do pacote de exportação. O arquivo de log usa ULS (Serviço de Log Unificado).

É recomendável usar esse parâmetro. Entretanto, por motivos de desempenho, não recomendamos a geração de um arquivo de log.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Path

Especifica o nome do arquivo de exportação.

Se o parâmetro NoFileCompression for usado, um diretório deverá ser especificado; do contrário, nenhum formato de arquivo será válido.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-PreserveDeletedUserMetadataReferences

Tenta opular o campo 'Author' ('Created By') para itens, mesmo que o objeto SPUser tenha sido marcado como excluído no site de destino.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-UpdateVersions

Indica como resolver situações onde um arquivo a ser importado para um site já existir nesse site. Se o parâmetro UpdateVersions estiver ausente, a operação de importação por padrão usará um valor de 1 (Append).

O tipo deve ser um dos seguintes:

-Append, que adiciona novas versões ao arquivo atual

-Substituir o arquivo e todas as versões (excluir e inserir)

-Ignorar o arquivo se ele existir no destino

O valor padrão é Adicionar novas versões ao arquivo atual.