Yesterday I threw up a quick post showing how to reset a SharePoint 2010 theme using a reasonably simple Windows PowerShell script. In that post I promised that I’d convert the script to a cmdlet and make it part of my downloadable extensions. Well, as promised I’ve updated my extensions so that they now include a
Reset-SPTheme cmdlet. I added on minor enhancement over the previously shown script in that I allow you to pass in either an
SPSite or an
SPWeb object and by default it will not force all child webs to inherit from the relevant
SPWeb object. This way, if you have a child Site with it’s own theme it won’t wipe out that theme. If you have multiple Sites with a custom theme setting within a Site Collection then you’ll want to provide the -Site parameter and pass in an
SPSite reference – this will result in all Sites with custom themes within the Site Collection to be reset. If you only wish to reset a single Site then use the -Web parameter and pass in a
Here’s the full help for the
NAME Reset-SPTheme SYNOPSIS Resets a theme by applying all user specified theme configuration settings to the original source files. This is particularly helpful when the original source files have changed to a Feature upgrade. SYNTAX Reset-SPTheme [-Web] <SPWebPipeBind> [-SetSubWebsToInherit <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [<CommonParameters>] Reset-SPTheme [-Site] <SPSitePipeBind> [-SetSubWebsToInherit <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [<CommonParameters>] DESCRIPTION Resets a theme by applying all user specified theme configuration settings to the original source files. This is particularly helpful when the original source files have changed to a Feature upgrade. Copyright 2011 Falchion Consulting, LLC > For more information on this cmdlet and others: > http://www.falchionconsulting.com/ > Use of this cmdlet is at your own risk. > Gary Lapointe assumes no liability. PARAMETERS -Web <SPWebPipeBind> Specifies the URL or GUID of the Web containing the theme to reset. The type must be a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh; a valid name of Microsoft SharePoint Foundation 2010 Web site (for example, MySPSite1); or an instance of a valid SPWeb object. Required? true Position? 1 Default value Accept pipeline input? true (ByValue, ByPropertyName) Accept wildcard characters? false -Site <SPSitePipeBind> The site containing the theme to reset. The type must be a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh; a valid URL, in the form http://server_name; or an instance of a valid SPSite object. Required? true Position? 1 Default value Accept pipeline input? true (ByValue, ByPropertyName) Accept wildcard characters? false -SetSubWebsToInherit [<SwitchParameter>] If specified, all child webs will be reset to inherit the theme of the specified web or root web. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false -AssignmentCollection [<SPAssignmentCollection>] Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used. When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur. Required? false Position? named Default value Accept pipeline input? true (ByValue) Accept wildcard characters? false <CommonParameters> This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, type, "get-help about_commonparameters". INPUTS OUTPUTS NOTES For more information, type "Get-Help Reset-SPTheme -detailed". For technical information, type "Get-Help Reset-SPTheme -full". ——————EXAMPLE 1———————– PS C:\> Get-SPSite http://server_name | Reset-SPTheme -SetSubWebsToInherit This example resets the theme for the site collection http://server_name and resets all child webs to inherit from the root web. ——————EXAMPLE 2———————– PS C:\> Get-SPWeb http://server_name/sub-web | Reset-SPTheme This example resets the theme for the web http://server_name/sub-web. RELATED LINKS Get-SPWeb Get-SPSite
In the following example I’m resetting the theme(s) for an entire Site Collection. If one any child Sites within the Site Collection have a custom theme then they’ll be updated, not just the root (inheritance will not be changed):
1PS C:\> Reset-SPTheme -Site "http://example.com"
In this next example I’m resetting all child Sites to inherit whatever theme has been specified for the root Site and I’m updating the root Site’s theme with changes to the source files:
1PS C:\> Reset-SPTheme -Site "http://example.com" -SetSubWebsToInherit
For this last example I’m resetting the theme of a specific sub-Site:
1PS C:\> Reset-SPTheme -Web "http://example.com"
As you can see, this is pretty easy to use and, if you’re deploying your branding via Features and you have theme support then a cmdlet like this can be quite critical when you need to push out updates to that brand.