Updated: 2010-04-22
Operation name: variationsfixuptool
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 [ http://go.microsoft.com/fwlink/?LinkId=148924 ] (http://go.microsoft.com/fwlink/?LinkId=148924) or Plan variations [ http://technet.microsoft.com/en-us/library/cc262404.aspx ] .
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: http://server/sites/pub
- Variations home URL: http://server/sites/pub/vhome
- Source variation root site URL: http://server/sites/pub/vhome/source
- Source variation subsite 1 URL: http://server/sites/pub/vhome/source/sub1
- Source variation subsite 2 URL: http://server/sites/pub/vhome/source/sub1/sub2
- Newly created source variation subsite URL: http://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 http://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 http://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 http://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 http://server/sites/pub/vhome/source/newsub
To display current status of Variations Timer Jobs, use the following syntax:
stsadm -o variationsfixuptool -fix -showrunningjobs -url http://server/sites/pub/vhome/source