Variationsfixuptool: Stsadm operation (Office SharePoint Server)

Applies To: Office SharePoint Server 2007

This Office product will reach end of support on October 10, 2017. To stay supported, you will need to upgrade. For more information, see , Resources to help you upgrade your Office 2007 servers and clients.

 

Topic Last Modified: 2016-11-14

Operation name: variationsfixuptool

Description

Lets an administrator correct variations system data on publishing sites or pages.

The variation features lets an administrator to control the different versions—or variations—of a publishing site or page.

For more information about variations, see About source variations (https://go.microsoft.com/fwlink/?LinkId=148924) or Plan variations.

Note

The variationsfixuptool operation was first introduced in Microsoft Office SharePoint Server 2007 with Service Pack 2 (SP2).

To scan all subsites, the recurse parameter must be used in conjunction with the scan parameter. This functionality change was first introduced in Microsoft SharePoint Server 2010.

Syntax

stsadm -o variationsfixuptool

**   -url <source variation site URL>**

**\[-scan\]**

**\[-recurse\]**

**\[-label\]**

**\[-fix\]**

**\[-spawn\]**

**\[-showrunningjobs\]**

Parameters

Parameter name

Value

Required?

Description

url

A valid URL, such as http://server_name

Yes

The URL of a site in source variation where variations system data is being analyzed or corrected.

scan

<none>

No

Analyzes the variations hierarchy and report findings.

This parameter provides functionality that cannot be accessed using the Central Administration Web site.

recurse

<none>

No

Scan or fix all subsites of the site specified by the url parameter.

label

A valid label name, such as "English"

No

Name of the label of the variation target.

fix

<none>

No

Corrects invalid variations system data that are found. If the recurse parameter is used, fixes are done recursively for all subsites.

Note

This parameter provides functionality that cannot be accessed using the Central Administration Web site.

spawn

<none>

No

Creates new site variations on the source variation site specified by the url parameter for all target variations labels. If the recurse parameter is used, variations for subsites and pages are also created.

This parameter equivalent to the New Variation Site user interface setting that is located on the Site Content and Structure page.

showrunningjobs

<none>

No

Displays current status of Variations Propagate Page Job Definition and Variations Propagate Site Job Definition timer jobs that are located on the Timer Job Status page of the SharePoint Central Administration Web site.

Examples

For the following examples, consider the following information:

  • Publishing site collection URL: https://server/sites/pub

  • Variations home URL: https://server/sites/pub/vhome

  • Source variation root site URL: https://server/sites/pub/vhome/source

  • Source variation subsite 1 URL: https://server/sites/pub/vhome/source/sub1

  • Source variation subsite 2 URL: https://server/sites/pub/vhome/source/sub1/sub2

  • Newly created source variation subsite URL: https://server/sites/pub/vhome/source/newsub

To scan the integrity of variations system data and write the Hypertext Markup Language (HTML) report to file "C:\report1.html", use the following syntax:

stsadm -o variationsfixuptool -scan -url https://server/sites/pub/vhome/source > C:\report1.html

To correct variations system data for source variation site sub1, use the following syntax:

stsadm -o variationsfixuptool -scan -url https://server/sites/pub/vhome/source/sub1 > C:\report1.html

To correct variations system data for source variation on site sub1 and all its subsites, use the following syntax:

stsadm -o variationsfixuptool -fix -url https://server/sites/pub/vhome/source/sub1 -recurse

To create new site variations for a newly created source variation site, use the following syntax:

stsadm -o variationsfixuptool -spawn -url https://server/sites/pub/vhome/source/newsub

To display current status of Variations Timer Jobs, use the following syntax:

stsadm -o variationsfixuptool -fix -showrunningjobs -url https://server/sites/pub/vhome/source