Import-SPWeb

Riferimento

Modulo:: SharePointServer

Si applica a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Importa un'applicazione Web, un elenco o una raccolta.

Sintassi

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

Descrizione

Il cmdlet Import-SPWeb importa un'applicazione Web, un elenco o una raccolta. La funzionalità di importazione da una raccolta è una nuova funzionalità di Prodotti SharePoint.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

---------------------ESEMPIO----------------------

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

Questo esempio consente di importare il contenuto del file export.cmp in un sito all'indirizzo https://site, sovrascrivendo il contenuto sottoposto a controllo delle versioni nel sito con il contenuto del file export.cmp.

Parametri

-ActivateSolutions

Specifica se le soluzioni utente vengono attivate durante l'importazione.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

Questo parametro non ha alcuna funzione in questo cmdlet.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-HaltOnError

Interrompe il processo di esportazione quando si verifica un errore.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-HaltOnWarning

Interrompe il processo di esportazione quando viene generato un avviso.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica l'URL o il GUID del sito Web in cui eseguire l'importazione.

Il tipo deve essere un URL, un GUID o un oggetto valido, ad esempio, un URL valido nel formato https://server_name o un GUID valido nel 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-IncludeUserCustomAction

Specifica se le azioni personalizzate dall'utente vengono incluse durante l'importazione.

I valori validi sono:

Tutti, Nessuno

Type:	SPIncludeUserCustomAction
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-IncludeUserSecurity

Mantiene le impostazioni di sicurezza dell'utente.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NoFileCompression

Abilita o disabilita la compressione dei file nel pacchetto di esportazione. Il pacchetto di esportazione è archiviato nella cartella specificata dal parametro Path o dal parametro Identity. È consigliabile utilizzare questo parametro per motivi di prestazioni. Se è abilitata la compressione, è possibile migliorare il processo di esportazione del 30% circa.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NoLogFile

Disattiva la generazione di un file di log dell'esportazione. Se questo parametro è assente, il cmdlet Import-SPWeb genererà un file di log dell'esportazione nella stessa posizione del pacchetto di esportazione. Il file di log utilizza ULS (Unified Logging Service).

È consigliabile utilizzare questo parametro. Tuttavia, per motivi di prestazioni, potrebbe essere preferibile non generare un file di log.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Path

Specifica il nome del file di esportazione.

Se si utilizza il parametro NoFileCompression, è necessario specificare una directory. In caso contrario, è valido qualsiasi formato di file.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-PreserveDeletedUserMetadataReferences

Tenta di opulare il campo 'Author' ('Created By') per gli elementi anche se l'oggetto SPUser è stato contrassegnato come eliminato nel sito di destinazione.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UpdateVersions

Indica come risolvere situazioni in cui un file da importare in un sito esiste già in tale sito. Se il parametro UpdateVersions è assente, l'operazione di importazione utilizza per impostazione predefinita il valore 1 (Append).

Il tipo deve essere uno dei seguenti:

-Append, che aggiunge nuove versioni al file corrente

-Sovrascrivere il file e tutte le relative versioni (eliminare e quindi inserire)

-Ignora il file se esiste nella destinazione

Il valore predefinito è Aggiungi nuove versioni al file corrente.