Import: Stsadm operation (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2010-04-26

Operation name: Import

Description

Imports site and subsite data from your Windows SharePoint Services 3.0 installation.

Syntax

stsadm -o import

**   -url <URL name>**

**   -filename <import file name>**

**\[-includeusersecurity\]**

**\[-haltonwarning\]**

**\[-haltonfatalerror\]**

**\[-nologfile\]**

**\[-updateversions\] \<1-3\>**

**\[-nofilecompression\]**

**\[-quiet\]**

Parameters

Parameter Value Required? Description

url

A valid URL, such as "http://server_name"

Yes

Specifies the URL of the site collection or site to be imported.

In SharePoint 2010 Products, specifies the URL of the site collection, site, or list to be imported.

filename

If using the –nofilecompression parameter, a directory must be specified; otherwise, any file format is valid.

Yes

Name of the import file

includeusersecurity

<none>

No

Preserves the user security settings

haltonwarning

<none>

No

When a warning occurs, the import process is stopped.

haltonfatalerror

<none>

No

When an error occurs, the import process is stopped.

nologfile

<none>

No

Suppresses the generation of an import log file. If this parameter is absent, the import operation will generate an import log file in the same location as the import package. The log file uses Unified Logging Service (ULS).

It is recommended to use this parameter. However, for performance reasons, you might not want to generate a log file.

updateversions

Any one of the following versions:

  1. Add new versions to the current file (default)

  2. Overwrite the file and all of its versions (delete then insert)

  3. Ignore the file if it exists on the destination

No

Indicates how to resolve situations where a file to be imported to a site already exists in that site. If the -updateversions parameter is absent, the import operation will default to using a value of 1.

nofilecompression

<none>

No

Either enables or disables file compression in the import package. The import package is stored in the folder specified by the -filename parameter. It is recommended to use this parameter for performance reasons. If compression is enabled, it can increase the import process by approximately 30%.

quiet

<none>

No

Suppresses the output of import progress information to the display window. The final import status (“Operation completed successfully.”) will still be displayed. If the -quiet parameter is absent, the import operation will display progress information to the display window as it imports a package. For performance reasons, it is recommended to use this parameter because the buffer of the display window is small compared to writing a file.