Setting List Properties using STSADM – SharePoint Automation

Recently I had a reader of my blog send me a modified version of my gl-addlist command in which he added some additional properties to set a couple of the SPList properties (specifically the versioning settings). In thinking about this I decided that it might be helpful to have a command specifically for setting most of the SPList properties rather than try to incorporate them into a more general command like the gl-addlist command so I decided to create a new command that I called gl-setlistproperties.

Now ideally you would just use PowerShell to set list properties and you can do so pretty easily using my custom CmdLet: Get-SPList. Here’s an example of how you could do this using my CmdLet:

$list = Get-SPList http://portal/documents
$list.EnableVersioning = $true
$list.EnableMinorVersions = $true
$list.EnableModeration = $true
$list.Update()

For a full list of the properties that you can set see the SPList documentation in the SDK. But if you’re not a PowerShell guy and prefer batch files then you can use my gl-setlistproperties command instead. The code, as you can imagine, is really simple:

using System;
using System.Collections.Specialized;
using System.Text;
using Lapointe.SharePoint.STSADM.Commands.OperationHelpers;
using Lapointe.SharePoint.STSADM.Commands.SPValidators;
using Microsoft.SharePoint;
  
namespace Lapointe.SharePoint.STSADM.Commands.Lists
{
    public class SetListProperties : SPOperation
    {
        internal enum VersionSettings {None, Major, MajorMinor}
        /// <summary>
        /// Initializes a new instance of the <see cref="SetListProperties"/> class.
        /// </summary>
        public SetListProperties()
        {
            SPParamCollection parameters = new SPParamCollection();
            parameters.Add(new SPParam("url", "url", true, null, new SPUrlValidator(), "Please specify URL to the list."));
            SPEnumValidator versionValidator = new SPEnumValidator(typeof(VersionSettings));
            parameters.Add(new SPParam("versioning", "version", false, null, versionValidator, "Please specify the version settings."));
            SPEnumValidator draftVisibilityValidator = new SPEnumValidator(typeof(DraftVisibilityType));
            parameters.Add(new SPParam("draftvisibility", "dvv", false, null, draftVisibilityValidator));
            parameters.Add(new SPParam("majorversionlimit", "mvl", false, "0", new SPIntRangeValidator(0, 50000)));
            parameters.Add(new SPParam("majorwithminorversionlimit", "mmvl", false, "0", new SPIntRangeValidator(0, 50000)));
            parameters.Add(new SPParam("forcecheckout", "fc", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("enablemoderation", "mod", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("enablecontenttypes", "ect", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("enablefoldercreation", "efc", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("allowdeletion", "del", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("alloweveryoneviewitems", "aevi", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("enablesyndication", "syn", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("hidden", "hidden", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("onquicklaunch", "oql", false, null, new SPTrueFalseValidator()));
            SPEnumValidator itemOpenValidator = new SPEnumValidator(typeof(DefaultItemOpen));
            parameters.Add(new SPParam("defaultitemopen", "open", false, null, itemOpenValidator));
            parameters.Add(new SPParam("ordered", "ordered", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("title", "title", false, null, new SPNullOrNonEmptyValidator()));
            parameters.Add(new SPParam("description", "desc", false, null, new SPNullOrNonEmptyValidator()));
            parameters.Add(new SPParam("nocrawl", "nocrawl", false, null, new SPTrueFalseValidator()));
            parameters.Add(new SPParam("enableattachments", "att", false, null, new SPTrueFalseValidator()));
  
            StringBuilder sb = new StringBuilder();
            sb.Append("\r\n\r\nSets various properties of a list.\r\n\r\nParameters:");
            sb.Append("\r\n\t-url <URL to the list to update>");
            sb.Append("\r\n\t[-title <title of the list>]");
            sb.Append("\r\n\t[-description <title of the list>]");
            sb.AppendFormat("\r\n\t[-versioning <{0}>", versionValidator.DisplayValue);
            sb.AppendFormat("\r\n\t[-draftvisibility <{0}>", draftVisibilityValidator.DisplayValue);
            sb.Append("\r\n\t[-majorversionlimit <0 - 50000>]");
            sb.Append("\r\n\t[-majorwithminorversionlimit <0 - 50000>]");
            sb.Append("\r\n\t[-forcecheckout <true | false>]");
            sb.Append("\r\n\t[-enablemoderation <true | false>]");
            sb.Append("\r\n\t[-enablecontenttypes <true | false>]");
            sb.Append("\r\n\t[-enablefoldercreation <true | false>]");
            sb.Append("\r\n\t[-allowdeletion <true | false>]");
            sb.Append("\r\n\t[-alloweveryoneviewitems <true | false>]");
            sb.Append("\r\n\t[-enablesyndication <true | false>]");
            sb.Append("\r\n\t[-hidden <true | false>]");
            sb.Append("\r\n\t[-onquicklaunch <true | false>]");
            sb.AppendFormat("\r\n\t[-defaultitemopen <{0}>", itemOpenValidator.DisplayValue);
            sb.Append("\r\n\t[-ordered <true | false>]");
            sb.Append("\r\n\t[-nocrawl <true | false>]");
            sb.Append("\r\n\t[-enableattachments <true | false>]");
            Init(parameters, sb.ToString());
        }
  
       
        #region ISPStsadmCommand Members
  
        /// <summary>
        /// Gets the help message.
        /// </summary>
        /// <param name="command">The command.</param>
        /// <returns></returns>
        public override string GetHelpMessage(string command)
        {
            return HelpMessage;
        }
  
        /// <summary>
        /// Runs the specified command.
        /// </summary>
        /// <param name="command">The command.</param>
        /// <param name="keyValues">The key values.</param>
        /// <param name="output">The output.</param>
        /// <returns></returns>
        public override int Execute(string command, StringDictionary keyValues, out string output)
        {
            output = string.Empty;
            Verbose = true;
  
            string url = Params["url"].Value.TrimEnd('/');
  
            using (SPSite site = new SPSite(url))
            using (SPWeb web = site.OpenWeb())
            {
                SPList list = Utilities.GetListFromViewUrl(web, url);
  
                if (list == null)
                    throw new SPException("List was not found.");
  
  
                if (Params["versioning"].UserTypedIn)
                {
                    VersionSettings versioning =
                        (VersionSettings) Enum.Parse(typeof (VersionSettings), Params["versioning"].Value, true);
                    SetVersioning(list, versioning);
                }
  
  
                SetProperties(list,
                    GetValue(list.Title, "title"),
                    GetValue(list.Title, "description"),
                    GetValue(list.ContentTypesEnabled, "enablecontenttypes"),
                    GetValue(list.DraftVersionVisibility, "draftvisibility"),
                    GetValue(list.MajorVersionLimit, "majorversionlimit"),
                    GetValue(list.MajorWithMinorVersionsLimit, "majorwithminorversionlimit"),
                    GetValue(list.ForceCheckout, "forcecheckout"),
                    GetValue(list.EnableModeration, "enablemoderation"),
                    GetValue(list.EnableFolderCreation, "enablefoldercreation"),
                    GetValue(list.AllowDeletion, "allowdeletion"),
                    GetValue(list.AllowEveryoneViewItems, "alloweveryoneviewitems"),
                    GetValue(list.EnableSyndication, "enablesyndication"),
                    GetValue(list.DefaultItemOpen, "defaultitemopen"),
                    GetValue(list.Hidden, "hidden"),
                    GetValue(list.OnQuickLaunch, "onquicklaunch"),
                    GetValue(list.Ordered, "ordered"),
                    GetValue(list.NoCrawl, "nocrawl"),
                    GetValue(list.EnableAttachments, "enableattachments"));
  
                list.Update();
            }
  
            return OUTPUT_SUCCESS;
        }
  
        #endregion
  
        /// <summary>
        /// Gets the value.
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="defaultValue">The default value.</param>
        /// <param name="paramName">Name of the param.</param>
        /// <returns></returns>
        private T GetValue<T>(T defaultValue, string paramName)
        {
            if (!Params[paramName].UserTypedIn)
                return defaultValue;
  
            string val = Params[paramName].Value;
            if (typeof(T).IsEnum)
                return (T) Enum.Parse(typeof (T), val, true);
  
            return (T)Convert.ChangeType(val, typeof (T));
  
        }
  
        /// <summary>
        /// Sets the properties.
        /// </summary>
        /// <param name="list">The list.</param>
        /// <param name="title">The title.</param>
        /// <param name="description">The description.</param>
        /// <param name="contentTypesEnabled">if set to <c>true</c> [content types enabled].</param>
        /// <param name="draftVisibility">The draft visibility.</param>
        /// <param name="majorVersionLimit">The major version limit.</param>
        /// <param name="majorWithMinorVersionLimit">The major with minor version limit.</param>
        /// <param name="forceCheckout">if set to <c>true</c> [force checkout].</param>
        /// <param name="enableModeration">if set to <c>true</c> [enable moderation].</param>
        /// <param name="enableFolderCreation">if set to <c>true</c> [enable folder creation].</param>
        /// <param name="allowDeletion">if set to <c>true</c> [allow deletion].</param>
        /// <param name="allowEveryoneViewItems">if set to <c>true</c> [allow everyone view items].</param>
        /// <param name="enableSyndication">if set to <c>true</c> [enable syndication].</param>
        /// <param name="itemOpen">The item open.</param>
        /// <param name="hidden">if set to <c>true</c> [hidden].</param>
        /// <param name="onQuickLaunch">if set to <c>true</c> [on quick launch].</param>
        /// <param name="ordered">if set to <c>true</c> [ordered].</param>
        /// <param name="noCrawl">if set to <c>true</c> [no crawl].</param>
        /// <param name="enableAttachments">if set to <c>true</c> [enable attachments].</param>
        private void SetProperties(SPList list,
            string title,
            string description,
            bool contentTypesEnabled,
            DraftVisibilityType draftVisibility,
            int majorVersionLimit,
            int majorWithMinorVersionLimit,
            bool forceCheckout,
            bool enableModeration,
            bool enableFolderCreation,
            bool allowDeletion,
            bool allowEveryoneViewItems,
            bool enableSyndication,
            DefaultItemOpen itemOpen,
            bool hidden,
            bool onQuickLaunch,
            bool ordered,
            bool noCrawl,
            bool enableAttachments)
        {
            list.Title = title;
            list.Description = description;
  
            if (list.AllowContentTypes || !contentTypesEnabled)
                list.ContentTypesEnabled = contentTypesEnabled;
  
            list.DraftVersionVisibility = draftVisibility;
  
            if (enableModeration && list.BaseTemplate == SPListTemplateType.PictureLibrary)
                Log("WARNING: Cannot set moderation on a picture library.");
            else
                list.EnableModeration = enableModeration;
  
            if (list.EnableVersioning)
                list.MajorVersionLimit = majorVersionLimit;
  
            if (list.EnableMinorVersions && list.EnableModeration)
                list.MajorWithMinorVersionsLimit = majorWithMinorVersionLimit;
  
  
            if (list.BaseTemplate == SPListTemplateType.DocumentLibrary)
                list.ForceCheckout = forceCheckout;
            else if (forceCheckout)
                Log("WARNING: Force checkout can only be set on document libraries.");
  
            list.EnableFolderCreation = enableFolderCreation;
            list.AllowDeletion = allowDeletion;
            list.AllowEveryoneViewItems = allowEveryoneViewItems;
            list.EnableSyndication = enableSyndication;
            list.DefaultItemOpen = itemOpen;
            list.Hidden = hidden;
            list.OnQuickLaunch = onQuickLaunch;
            list.NoCrawl = noCrawl;
            
            if (list.BaseTemplate == SPListTemplateType.GenericList)
                list.Ordered = ordered;
            else if (ordered)
                Log("WARNING: The Ordered property can only be set for generic lists.");
  
            if (!enableAttachments)
                list.EnableAttachments = false;
            else
            {
                if (!(list.BaseType == SPBaseType.DocumentLibrary || list.BaseType == SPBaseType.Survey))
                    list.EnableVersioning = true;
                else
                    Log("WARNING: Attachments are only allowed on document libraries and surveys.");
            }
  
  
        }
  
        /// <summary>
        /// Sets the versioning.
        /// </summary>
        /// <param name="list">The list.</param>
        /// <param name="versioning">The versioning.</param>
        private void SetVersioning(SPList list, VersionSettings versioning)
        {
            switch (versioning)
            {
                case VersionSettings.None:
                    list.EnableVersioning = false;
                    list.EnableMinorVersions = false;
                    break;
                case VersionSettings.Major:
                    list.EnableVersioning = true;
                    list.EnableMinorVersions = false;
                    break;
                case VersionSettings.MajorMinor:
                    list.EnableVersioning = true;
                    list.EnableMinorVersions = true;
                    break;
            }
        }
    }
}

The help for the command is shown below:

C:\>stsadm -help gl-setlistproperties

stsadm -o gl-setlistproperties


Sets various properties of a list.

Parameters:
        -url <URL to the list to update>
        [-title <title of the list>]
        [-description <title of the list>]
        [-versioning <none | major | majorminor>
        [-draftvisibility <reader | author | approver>
        [-majorversionlimit <0 - 50000>]
        [-majorwithminorversionlimit <0 - 50000>]
        [-forcecheckout <true | false>]
        [-enablemoderation <true | false>]
        [-enablecontenttypes <true | false>]
        [-enablefoldercreation <true | false>]
        [-allowdeletion <true | false>]
        [-alloweveryoneviewitems <true | false>]
        [-enablesyndication <true | false>]
        [-hidden <true | false>]
        [-onquicklaunch <true | false>]
        [-defaultitemopen <preferclient | browser>
        [-ordered <true | false>]
        [-nocrawl <true | false>]
        [-enableattachments <true | false>]

The following table summarizes the command and its various parameters:

Command Name	Availability	Build Date
gl-setlistproperties	WSS 3.0 MOSS 2007	Released: 7/6/2009

Parameter Name	Short Form	Required	Description	Example Usage
url		Yes	The URL of the list or library to update.	-url http://portal/documents
title		No	String representing the title of the list. Corresponds to the SPList.Title property.	-title Documents
description	desc	No	String representing the description of the list. Corresponds to the SPList.Description property.	-description "Shared Documents" -desc "Shared Documents"
versioning	version	No	Sets whether to enable versioning and if minor versions should be created or not (sets the SPList.EnableVersioning and the SPList.EnableMinorVersions properties). Valid values are “none”, “major”, and “majorminor”.	-versioning majorminor -version majorminor
draftvisibility	dvv	No	Sets a value that determines the type of user who can view minor versions of document drafts within the list. Corresponds to the SPList.DraftVersionVisibility property. Valid values are “reader”, “author”, and “approver”.	-draftvisibility approver -dvv approver
majorversionlimit	mvl	No	Sets the maximum number of major versions allowed for an item in a document library that uses version control with major versions only. Corresponds to the SPList.MajorVersionLimit property.	-majorversionlimit 3 -mvl 3
majorwithminorversionlimit	mmvl	No	Sets the maximum number of major versions that are allowed for an item in a document library that uses version control with both major and minor versions. Corresponds to the SPList.MajorWithMinorVersionsLimit property.	-majorwithminorversionlimit 3 -mmvl 3
forcecheckout	fc	No	Sets whether forced checkout is enabled for the document library. Valid values are “true” and “false”. Corresponds to the SPList.ForceCheckout property.	-forcecheckout true -fc true
enablemoderation	mod	No	Sets whether Content Approval is enabled for the list. Valid values are “true” and “false”. Corresponds to the SPList.EnableModeration property.	-enablemoderation true -mod true
enablecontenttypes	ect	No	Sets whether content types are enabled for the list. Valid values are “true” and “false”. Corresponds to the SPList.ContentTypesEnabled property.	-enablecontenttypes true -ect true
enablefoldercreation	efc	No	Sets whether folders can be created for the list. Valid values are “true” and “false”. Corresponds to the SPList.EnableFolderCreation property.	-enablefoldercreation true -efc true
allowdeletion	del	No	Sets whether the list can be deleted. Valid values are “true” and “false”. Corresponds to the SPList.AllowDeletion property.	-allowdeletion true -del true
alloweveryoneviewitems	aevi	No	Sets whether everyone can view documents in the document library or attachments to items in the list. Valid values are “true” and “false”. Corresponds to the SPList.AllowEveryoneViewItems property.	-alloweveryoneviewitems true -aevi true
enablesyndication	syn	No	Sets whether RSS syndication is enabled for the list. Valid values are “true” and “false”. Corresponds to the SPList.EnableSyndication property.	-enablesyndication true -syn true
hidden		No	Sets whether the list is hidden. Valid values are “true” and “false”. Corresponds to the SPList.Hidden property.	-hidden false
onquicklaunch	oql	No	Sets whether the list appears on the Quick Launch of the home page. Valid values are “true” and “false”. Corresponds to the SPList.OnQuickLaunch property.	-onquicklaunch true -oql true
defaultitemopen	open	No	Sets whether to open list items in a client application or in the browser. Valid values are “preferclient” and “browser”. Corresponds to the SPList.DefaultItemOpen property.	-defaultitemopen preferclient -open preferclient
ordered		No	Sets whether the option to allow users to reorder items in the list is available on the Edit View page for the list. Valid values are “true” and “false”. Corresponds to the SPList.Ordered property.	-ordered true
nocrawl		No	Sets whether crawling is enabled for the list. Valid values are “true” and “false”. Corresponds to the SPList.NoCrawl property.	-nocrawl false
enableattachments	att	No	Sets whether attachments can be added to items in the list. Valid values are “true” and “false”. Corresponds to the SPList.EnableAttachments property.	-enableattachments false -att false

The following is an example of how to set a few properties on a list:

stsadm -o gl-setlistproperties -url http://portal/documents -versioning majorminor -enablemoderation true -draftvisibility approver

Note that I’m not exposing every property on the SPList class but I believe I’ve hit the more widely used ones.

2 thoughts on “Setting List Properties using STSADM”

Bas says:

August 16, 2009 at 8:08 am

Hi Gary. Cool that you’ve created a whole new command for this functionality! Appreciate it.
Christian says:

October 6, 2010 at 9:16 am

Hi Gary,

In the gl-setlistproperties command, why does the majorwithminorversionlimit parameter need the Content Approval to be enabled?

if (list.EnableMinorVersions && list.EnableModeration) list.MajorWithMinorVersionsLimit = majorWithMinorVersionLimit;

In the web interface, the content approval doesn’t need to be enabled for the “Keep drafts for the following number of major versions” to be used.

Thanks,
Christian

Comments are closed.